Blok funkce FS_READLINE

Blok funkce FS_READLINE čte data řádkově 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.

Poznámka: Maximální velikost řádku, který lze přečíst, je z bezpečnostních důvodů 1024'000 bajtů.

Souborový systém musí být předem 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 pozitivní hraně se data čtou ze zařízení.

Vstup DEV

Definuje zařízení, ze kterého má být přístupováno k souborům. Zařízení se používá pro projekt a může být spravováno 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 v UTF-8 formátu, pokud je podporována. Cesta se zobrazuje takto:

Složka/Podsložka/Soubor.txt

Vstup LINE

Definuje řádek, který má být přečten. První řádek začíná číslem 0.

Vstup ENDING

Definuje konec řádku. Tento se zadává pomocí escape sekvencí: "\r\n". Pokud není vstup definován, předpokládá se "\n".

U následujících znaků se bere v úvahu escape sekvence:

  • "\t" (ASCII 9 (0x09)), tabulátor.
  • "\n" (ASCII 10 (0x0A)), posun řádku (Line Feed).
  • "\r" (ASCII 13 (0x0D)), návrat vozíku (Carriage Return).
  • "\0" (ASCII 0 (0x00)), NUL byte.
  • '\xEF' zápis pro bajty.

Poznámka: Aby bylo možné definovat i binární znaky, jako například '\xEF', musí být zadány v jednoduchých uvozovkách.

Výstup DONE

Výstup při úspěchu 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í přečtený řádek včetně konce řádku. 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. Tento 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é.
  • Vzdálený server nebyl dosažen.
  • Úložné médium neexistuje.
  • Zadaná cesta je neplatná.