Blok funkce FS_READ

Blok funkce FS_READ čte data z souboru.

Pozor: Při čtení velmi velkých souborů může SPS nebo celé systém selhat a již nebude možné jej spustit. Používejte vstup LENGTH=0 pouze s opatrností.

Souborový systém musí být předtím inicializován pomocí FS_INIT. Všechny operace se provádějí asynchronně pro každé vytvořené úložné médium.

Vstup READ

Při kladné hraně se data načtou ze zařízení.

Vstup DEV

Definuje zařízení, z něhož je třeba přístupovat ke souborům. Zařízení se používá pro projekt a lze jej spravovat v kontextovém menu pod Projekt ▸ Externí úložiště.

Vstup PATH

Zadává cestu k souboru na úložném médiu. Cesta odpovídá Unixové cestě k souboru ve formátu UTF-8, pokud je podporována. Cesta se zobrazuje následovně:

Složka/Podsložka/Soubor.txt

Vstup OFFSET

Definuje posun v bytech, od kterého má být čtení zahájeno. Pokud není definován žádný posun, bude čteno od začátku souboru.

Vstup LENGTH

Definuje maximální délku, do které bude čtení ukončeno. Pokud není vstup definován, bude čteno až do konce souboru.

Poznámka: Maximální velikost pro čtení při LENGTH=0 činí z bezpečnostních důvodů 1 024 000 bajtů.

Výstup DONE

Výstup při úspěšném provedení vrátí impuls, aby se mohla provést další operace. Impuls nastane při ukončení procesu, i když došlo k chybě.

Výstup DATA

Vrátí načtená data. Stav je uložen pro pozdější použití.

Výstup EOF

Pokud byl dosažen konec souboru, vstup je pravdivý.

Výstup BOM

Pokud bylo nalezeno UTF-8 Byte Order Mark, výstup je pravdivý. BOM se určuje při každém čtení.

Výstup ERROR

V případě chyby vrátí text s chybovou zprávou. Je FALSE, pokud nevyšlo nic špatně. Stav je uložen pro pozdější použití.

Možné příčiny:

• Služba úložného média nebyla spuštěna.
• Úložiště nebylo inicializováno.
• Přihlašovací údaje jsou neplatné.
• Nebylo možné dosáhnout vzdáleného serveru.
• Úložné médium neexistuje.
• Zadaná cesta je neplatná.