Funktionsblok FS_READ

Funktionsblokken FS_READ læser data fra en fil.

Advarsel: Ved læsning af meget store filer kan SPS'en eller hele systemet krashe og ikke starte igen. Brug indgangen LENGTH=0 kun med forsigtighed.

Filssystemet skal først initialiseres ved hjælp af FS_INIT. Alle operationer udføres asynkrone for hvert oprettet lagringsmedium.

Indgang READ

Ved en positiv flanke læses dataene fra lagringsmediet.

Indgang DEV

Definerer enheden, hvorfra filerne skal tilgås. Enheden bruges pr. projekt og kan administreres i kontekstmenuen under Projekt ▸ Ekstern lagring.

Indgang PATH

Angiver stien til filen på lagringsmediet. Stien svarer til en Unix-filsti i UTF-8-format, hvis dette understøttes. Stien vises som følger:

Mappe/Undermappe/Fil.txt

Indgang OFFSET

Definerer offsettet i bytes, hvorfra der skal læses. Hvis der ikke er defineret et offset, læses der fra begyndelsen af filen.

Indgang LENGTH

Definerer den maksimale længde, indtil læsningen stoppes. Hvis indgangen ikke er defineret, læses der til slutningen af filen.

Note: Den maksimale læsbare størrelse ved LENGTH=0 er på grund af sikkerhedsmæssige årsager 1.024.000 bytes.

Udgang DONE

Udgangen returnerer ved succes en impuls til at udføre den næste operation. Impulsen opstår, når processen er afsluttet, også hvis der er opstået en fejl.

Udgang DATA

Returnerer de læste data. Tilstanden gemmes til senere brug.

Udgang EOF

Hvis slutningen af filen er nået, er indgangen sand.

Udgang BOM

Hvis UTF-8 Byte Order Mark blev fundet, er udgangen sand. BOM bestemmes ved hver læsning.

Udgang ERROR

Returnerer i tilfælde af fejl en tekst med en fejlbesked. Denne er FALSE, hvis der ikke er opstået nogen fejl. Tilstanden gemmes til senere brug.

Mulige årsager:

• Tjenesten for lagringsmediet blev ikke startet.
• Lagringen blev ikke initialiseret.
• Logindataene er ugyldige.
• Den fjerne server kunne ikke nås.
• Lagringsmediet findes ikke.
• Den angivne sti er ugyldig.