Funkcióblokk FS_READLINE

A Funkcióblokk FS_READLINE soronként olvassa be az adatokat egy fájlból.

Figyelem: Nagy fájlok olvasásakor a PLC vagy az egész rendszer leállhat és nem indul újra.

Megjegyzés: Egy sor maximális olvasható mérete biztonsági okokból 1'024'000 bájt.

A fájlrendszert előbb az FS_INIT segítségével kell inicializálni. Az összes művelet aszinkron módon történik, minden létrehozott tárolóeszközre.

READ bemenet

Egy pozitív él esetén az adatok beolvasása történik a tárolóeszközből.

DEV bemenet

Azonosítja az eszközt, amelyről a fájlokhoz való hozzáférést kell végrehajtani. Az eszköz projektként van meghatározva és kezelhető a kontextusmenüben Projekt ▸ Külső tároló alatt.

PATH bemenet

A fájl elérési útját adja meg a tárolóeszközön. Az elérési út egy Unix-fájlelérési úthoz hasonló, UTF-8 formátumban, ha ez támogatott. Az elérési út a következőképpen jelenik meg:

Mappa/Almappa/Fájl.txt

LINE bemenet

Azonosítja azt a sort, amelyet be kell olvasni. Az első sor a 0 számmal kezdődik.

ENDING bemenet

A sorvég jelölését határozza meg. Ez escape karakterekkel van megadva: "\r\n". Ha a bemenet nincs meghatározva, akkor "\n" lesz feltételezve.

A következő karaktereknél figyelembe veszik az escape karaktert:

  • "\t" (ASCII 9 (0x09)), egy tabulátorjel.
  • "\n" (ASCII 10 (0x0A)), sorelőző jel (Line Feed).
  • "\r" (ASCII 13 (0x0D)), visszajelző jel (Carriage Return).
  • "\0" (ASCII 0 (0x00)), a NUL-bájt.
  • '\xEF' Bájtok írási formája.

Megjegyzés: A bináris karakterek, például '\xEF', definiálásához egyszerű idézőjelek között kell megadni őket.

DONE kimenet

A kimenet siker esetén egy impulzust ad vissza, hogy a következő művelet végrehajtása történjen meg. Az impuls akkor történik meg, ha a művelet befejeződött, még akkor is, ha hiba történt.

DATA kimenet

A beolvasott sort adja vissza, beleértve a sorvég jelet. Az állapot el van mentve későbbi használatra.

EOF kimenet

Ha a fájl vége elérésre került, akkor a bemenet igaz.

BOM kimenet

Ha az UTF-8 bájtrend-szignót találták meg, akkor a kimenet igaz. A BOM minden olvasási művelet során meghatározódik.

ERROR kimenet

Hiba esetén egy szöveg ad vissza egy hibajelzéssel. Ez FALSE, ha nincs hiba történt. Az állapot el van mentve későbbi használatra.

Lehetséges okok:

  • A tárolóeszköz szolgáltatása nem indult el.
  • A tároló nem lett inicializálva.
  • A bejelentkezési adatok érvénytelenek.
  • A távoli szerver nem érhető el.
  • A tárolóeszköz nem létezik.
  • Az megadott elérési út érvénytelen.