Blok funkce FS_WRITE
Blok funkce FS_WRITE zapisuje data do souborového systému.
Pozor: Pokud již existující soubory budou bez varování přepsány.
Souborový systém musí být předtím pomocí FS_INIT inicializován. Všechny operace se provádějí asynchronně pro každé vytvořené úložné médium.
Vstup WRITE
Při kladném okraji se data zapíší do úložného média.
Vstup DEV
Definuje zařízení, ze kterého má být přístupováno ke 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
Udá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 následovně:
Složka/Podsložka/Soubor.txt
Vstup DATA
Definuje data, která mají být zapsána.
Vstup MODE
Udává režim, ve kterém má být soubor zapsán. Možné režimy jsou:
| Režim | Popis |
|---|---|
| "r" | Otevřený pouze pro čtení. Umístí ukazatel souboru na začátek souboru. |
| "r+" | Otevřený pouze pro čtení a zápis. Umístí ukazatel souboru na začátek souboru. |
| "w" | Otevřený pouze pro zápis. Umístí ukazatel souboru na začátek souboru. Vymaže obsah souboru. Pokud soubor neexistuje, bude vytvořen. |
| "w+" | Otevřený pouze pro zápis a čtení. Umístí ukazatel souboru na začátek souboru. Vymaže obsah souboru. Pokud soubor neexistuje, bude vytvořen. |
| "a" | Otevřený pouze pro zápis. Umístí ukazatel souboru na konec souboru. Pokud soubor neexistuje, bude vytvořen. Data budou přidána na konec. |
| "a+" | Otevřený pouze pro zápis a čtení. Umístí ukazatel souboru na konec souboru. Pokud soubor neexistuje, bude vytvořen. Data budou přidána na konec. |
| "x" | Otevřený pouze pro zápis. Umístí ukazatel souboru na začátek souboru. Pokud soubor existuje, bude operace přerušena. |
| "x+" | Otevřený pouze pro zápis a čtení. Umístí ukazatel souboru na začátek souboru. Pokud soubor existuje, bude operace přerušena. |
| "c" | Otevřený pouze pro zápis. Umístí ukazatel souboru na začátek souboru. Pokud soubor neexistuje, bude vytvořen. Přepíše obsah souboru. |
| "c+" | Otevřený pouze pro zápis a čtení. Umístí ukazatel souboru na začátek souboru. Pokud soubor neexistuje, bude vytvořen. Přepíše obsah souboru. |
Vstup BOM
Pokud je vstup při zápisu pravdivý, přidá se UTF-8 Byte Order Mark na začátek souboru. To se děje pouze, pokud je soubor přepsán nebo nově vytvořen. Pokud nebylo BOM napsáno na začátek souboru, nelze jej později přidat.
Výstup DONE
Výstup při úspěchu vrátí impuls k provedení další operace. Impuls nastane při ukončení procesu, i když došlo k chybě.
Výstup LENGTH
Vrátí počet zapsaných bajtů. Stav se uloží pro pozdější použití.
Výstup ERROR
V případě chyby vrátí text s chybovou zprávou. Je FALSE, pokud neexistuje žádná chyba. Stav se uloží 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.
- Uvedená cesta je neplatná.
- Na úložné médium nelze zapisovat.
- Žádný volný prostor na úložišti nebo úložiště je chráněno proti zápisu.