Blok funkcija FS_READLINE

Blok funkcija FS_READLINE čita podatke redom iz datoteke.

Pažnja: Pri čitanju vrlo velikih datoteka može se SPS ili cijeli sustav zaletjeti i više ne pokrenuti.

Napomena: Maksimalna veličina čitanja jednog reda iz sigurnosnih razloga je 1024'000 bajta.

Datotečni sustav mora biti prethodno inicijaliziran putem FS_INIT. Sve operacije se tada izvode asinkrono po svakom napravljenom mediju za pohranu.

Ulaz READ

Pri pozitivnoj flanci se podatci čitaju s medija za pohranu.

Ulaz DEV

Definira uređaj, s kojeg se pristupa datotekama. Uređaj se koristi po projektu i može se upravljati u kontekstnom izborniku pod Projekt ▸ Vanjski pohrana.

Ulaz PATH

Navodi put do datoteke na mediju za pohranu. Put odgovara Unix-putu datoteci u UTF-8 formatu, ako je to podržano. Put se prikazuje ovako:

Folder/Subfolder/File.txt

Ulaz LINE

Definira red koji treba pročitati. Prvi red počinje s brojem 0.

Ulaz ENDING

Definira kraj reda. Ovo se navodi s escape sekvencama: "\r\n". Ako ulaz nije definiran, pretpostavlja se "\n".

Sljedeća znaka uzimaju se u obzir:

  • "\t" (ASCII 9 (0x09)), tabulatorni znak.
  • "\n" (ASCII 10 (0x0A)), prelazak u novi red (Line Feed).
  • "\r" (ASCII 13 (0x0D)), povratak na početak reda (Carriage Return).
  • "\0" (ASCII 0 (0x00)), NUL-bajt.
  • '\xEF' zapis za bajtove.

Napomena: Da bi se binarni znaci, kao npr. '\xEF', mogli definirati, moraju biti definirani u jednostrukim navodnicima.

Izlaz DONE

Izlaz vraća impuls pri uspjehu kako bi se sljedeća operacija izvela. Impuls se događa na kraju postupka, čak i ako je došlo do pogreške.

Izlaz DATA

Vraća pročitanu liniju, uključujući i kraj reda. Stanje se sprema za kasnije korištenje.

Izlaz EOF

Ako je kraj datoteke postignut, ulaz je istinit.

Izlaz BOM

Ako je pronađen UTF-8 Byte Order Mark, izlaz je istinit. BOM se određuje pri svakom čitanju.

Izlaz ERROR

U slučaju pogreške vraća tekst s porukom o pogrešci. Ovo je FALSE, ako nije došlo do pogreške. Stanje se sprema za kasnije korištenje.

Mogući uzroci:

  • Usluga medija za pohranu nije pokrenuta.
  • Pohrana nije inicijalizirana.
  • Podaci za prijavu nisu ispravni.
  • Daljinski server nije dostupan.
  • Medij za pohranu ne postoji.
  • Navedeni put je neispravan.