Funksjonsblokk FS_READ

Funksjonsblokken FS_READ leser data fra en fil.

Advarsel: Ved å lese veldig store filer kan SPS eller hele systemet krasje og ikke starte opp igjen. Bruk inngangen LENGTH=0 bare med forsiktighet.

Filssystemet må først initialiseres ved hjelp av FS_INIT. Alle operasjoner skjer asynkront per opprettet lagringsmedium.

Inngang READ

Når en positiv flanke oppstår, leses data fra lagringsmediet.

Inngang DEV

Definerer enheten som skal brukes for å få tilgang til filene. Enheten brukes per prosjekt og kan administreres i kontekstmenyen under Prosjekt ▸ Ekstern lagring.

Inngang PATH

Angir stien til filen på lagringsmediet. Stien tilsvarer en Unix-filsti i UTF-8-format, hvis dette støttes. Stien representeres som følger:

Mappe/Undermappe/Fil.txt

Inngang OFFSET

Definerer offsettet i bytes der lesingen skal starte. Hvis ingen offset er definert, leses det fra begynnelsen av filen.

Inngang LENGTH

Definerer den maksimale lengden til lesingen blir avsluttet. Hvis inngangen ikke er definert, leses det til slutten av filen.

Merknad: Den maksimale lesbare størrelsen ved LENGTH=0 er på grunn av sikkerhetsgrunner 1024'000 bytes.

Utgang DONE

Utgangen gir en puls ved suksess for å utføre neste operasjon. Pulsen skjer når prosessen er ferdig, også hvis det har oppstått en feil.

Utgang DATA

Returnerer de lest dataene. Tilstanden lagres for senere bruk.

Utgang EOF

Hvis slutten av filen er nådd, er inngangen sann.

Utgang BOM

Hvis UTF-8 Byte Order Mark ble funnet, er utgangen sann. BOM bestemmes ved hver leseoperasjon.

Utgang ERROR

Returnerer i feiltilfelle en tekst med en feilmelding. Denne er FALSE, hvis ingen feil har oppstått. Tilstanden lagres for senere bruk.

Mulige årsaker:

• Tjenesten til lagringsmediet ble ikke startet.
• Lagringen ble ikke initialisert.
• Innloggingsdataene er ugyldige.
• Den fjerne serveren kunne ikke nås.
• Lagringsmediet eksisterer ikke.
• Den angitte stien er ugyldig.