Funksjonsblokk FS_READLINE

Funksjonsblokken FS_READLINE leser data linje for linje fra en fil.

Advarsel: Ved å lese fra svært store filer kan SPS eller hele systemet krasje og ikke starte opp igjen.

Merknad: Den maksimale lesbare størrelsen på en linje er av sikkerhetsgrunner 1024'000 bytes.

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 LINE

Definerer linjen som skal leses. Den første linjen starter med nummeret 0.

Inngang ENDING

Definerer linjeskift. Dette angis med escape-sekvenser: "\r\n". Hvis inngangen ikke er definert, antas "\n".

For følgende tegn tas escape-sekvensen i betraktning:

  • "\t" (ASCII 9 (0x09)), et tabulatortegn.
  • "\n" (ASCII 10 (0x0A)), linjeskift (Line Feed).
  • "\r" (ASCII 13 (0x0D)), returtegn (Carriage Return).
  • "\0" (ASCII 0 (0x00)), NUL-byte.
  • '\xEF' Skriveform for bytes.

Merknad: For at også binære tegn, som f.eks. '\xEF', kan defineres, må de angis i enkle anførselstegn.

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 den lest linjen, inkludert linjeenden. 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 det ikke har oppstått noen feil. Tilstanden lagres for senere bruk.

Mulige årsaker:

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