Bloc funcțional FS_READLINE

Blocul funcțional FS_READLINE citește date pe rând dintr-un fișier.

Atenție: Când se citesc fișiere foarte mari, PLC-ul sau întreg sistemul poate să se blocheze și nu mai poate fi pornit.

Notă: Dimensiunea maximă citibilă a unei linii este de 1024'000 octeți, din motive de siguranță.

Sistemul de fișiere trebuie inițializat anterior prin intermediul FS_INIT. Toate operațiile se efectuează asincron pentru fiecare mediu de stocare creat.

Intrarea READ

La o frontieră pozitivă, datele sunt citite din mediu de stocare.

Intrarea DEV

Definește dispozitivul de unde se poate accesa fișierele. Dispozitivul este utilizat pe proiect și poate fi gestionat în meniul contextual sub Proiect ▸ Stocare Externă.

Intrarea PATH

Specifică calea către fișier pe mediu de stocare. Calea corespunde unui Unix file path în format UTF-8, dacă acesta este suportat. Calea este reprezentată astfel:

Folder/Subfolder/File.txt

Intrarea LINE

Definește linia care trebuie citită. Prima linie începe cu numărul 0.

Intrarea ENDING

Definește sfârșitul linii. Acesta este specificat cu escape: "\r\n". Dacă intrarea nu este definită, se presupune "\n".

Următoarele caractere iau în considerare escape:

  • "\t" (ASCII 9 (0x09)), un caracter de tabulare.
  • "\n" (ASCII 10 (0x0A)), un avans de linie (Line Feed).
  • "\r" (ASCII 13 (0x0D)), un caracter de returnare la începutul linii (Carriage Return).
  • "\0" (ASCII 0 (0x00)), byte-ul NUL.
  • '\xEF' Forma de scriere pentru octeți.

Notă: Pentru a defini și caractere binare, cum ar fi '\xEF', acestea trebuie definite în ghilimele simple.

Ieșirea DONE

Ieșirea returnază un impuls la succes, pentru a efectua următoarea operație. Impulsul are loc la finalizarea procesului, chiar dacă a apărut o eroare.

Ieșirea DATA

Returnează linia citită, inclusiv sfârșitul linii. Starea este salvată pentru utilizare ulterioară.

Ieșirea EOF

Dacă s-a ajuns la sfârșitul fișierului, intrarea este adevărată.

Ieșirea BOM

Dacă s-a găsit UTF-8 Byte Order Mark, ieșirea este adevărată. BOM-ul este determinat la fiecare operație de citire.

Ieșirea ERROR

Returnează în caz de eroare un text cu o mesaj de eroare. Acesta este FALSE, dacă nu a apărut nicio eroare. Starea este salvată pentru utilizare ulterioară.

Cauze posibile:

  • Serviciul mediu de stocare nu a fost pornit.
  • Memoria nu a fost inițializată.
  • Datele de conectare sunt invalide.
  • Serverul îndepărtat nu a putut fi contactat.
  • Mediu de stocare nu există.
  • Calea specificată este invalidă.