Funkcióblokk FS_READ
A Funkcióblokk FS_READ adatok olvasását végzi el egy fájlból.
Figyelmeztetés: Nagy méretű fájlok olvasásakor az SPS vagy az egész rendszer lefagyhat és nem indul újra. Használja csak óvatosan a LENGTH=0 bemenetet.
A fájlrendszert előbb inicializálni kell az FS_INIT segítségével. Az összes művelet aszinkron módon történik meg minden létrehozott tárolóeszközre.
Bemenet READ
Egy pozitív él esetén az adatok beolvasása történik meg a tárolóeszközből.
Bemenet DEV
Azonosítja az eszközt, amelyről a fájlokhoz való hozzáférést végzi el. Az eszköz projektként van meghatározva és kezelhető a kontextusmenü alatt Projekt Külső tároló.
Bemenet PATH
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 ezt támogatja. Az elérési út a következőképpen van megadva:
Mappa/Almappa/Fájl.txt
Bemenet OFFSET
A byte-ok számát adja meg, ahonnan kezdve történik meg az olvasás. Ha nincs meghatározva offset, akkor a fájl elejétől kezdődik az olvasás.
Bemenet LENGTH
A maximális hosszúságot adja meg, amíg az olvasás befejeződik. Ha a bemenet nincs meghatározva, akkor a fájl végéig történik meg az olvasás.
Megjegyzés: A maximális olvasható méret LENGTH=0 esetén biztonsági okokból 1'024'000 byte.
Kimenet DONE
A kimenet siker esetén egy impulzust ad vissza, hogy a következő művelet elvégzéséhez. Az impuls akkor történik meg, ha a folyamat befejeződik, még akkor is, ha hiba történt.
Kimenet DATA
A beolvasott adatokat adja vissza. Az állapot tárolva van későbbi használatra.
Kimenet EOF
Ha a fájl vége elért, akkor a bemenet igaz.
Kimenet BOM
Ha az UTF-8 byte sorrendje megtalálható, akkor a kimenet igaz. A BOM minden olvasási művelet során meghatározott.
Kimenet ERROR
Hiba esetén egy szöveg ad vissza egy hibajelzést. Ez FALSE, ha nem történt hiba. Az állapot tárolva van későbbi használatra.
Lehetséges okok:
- A tárolóeszköz szolgáltatása nem indult el.
- A tároló nem inicializálva.
- A bejelentkezési adatok érvénytelenek.
- A távoli szerver nem elérhető.
- A tárolóeszköz nem létezik.
- Az megadott elérési út érvénytelen.