Funkcióblokk FS_WRITE
A Funkcióblokk FS_WRITE adatok írását végzi egy fájlrendszerre.
Figyelem: A már létező fájlok felülírásra kerülnek, anélkül, hogy figyelmeztetést kapna.
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 meg minden létrehozott tárolóeszközre.
WRITE bemenet
Egy pozitív él esetén az adatok a tárolóeszközhöz íródnak.
DEV bemenet
Azonosítja az eszközt, amelyről a fájlokhoz való hozzáférést kell végrehajtani. Az eszközt projektként használják, és kezelni lehet 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átumú, ha ezt támogatja. Az elérési út a következőképpen jelenik meg:
Mappa/Almappa/Fajl.txt
DATA bemenet
Azonosítja azokat az adatokat, amelyek íródni fognak.
MODE bemenet
A módot határozza meg, amely szerint a fájlt írni kell. Lehetséges módok:
| Mód | Leírás |
|---|---|
| "r" | Csak olvasásra nyitott. A fájlmutatót a fájl elejére helyezzi. |
| "r+" | Csak olvasásra és írásra nyitott. A fájlmutatót a fájl elejére helyezzi. |
| "w" | Csak írásra nyitott. A fájlmutatót a fájl elejére helyezzi. Törli a fájl tartalmát. Ha a fájl nem létezik, létrehozza azt. |
| "w+" | Csak írásra és olvasásra nyitott. A fájlmutatót a fájl elejére helyezzi. Törli a fájl tartalmát. Ha a fájl nem létezik, létrehozza azt. |
| "a" | Csak írásra nyitott. A fájlmutatót a fájl végére helyezzi. Ha a fájl nem létezik, létrehozza azt. Az adatok a végén kerülnek hozzáadva. |
| "a+" | Csak írásra és olvasásra nyitott. A fájlmutatót a fájl végére helyezzi. Ha a fájl nem létezik, létrehozza azt. Az adatok a végén kerülnek hozzáadva. |
| "x" | Csak írásra nyitott. A fájlmutatót a fájl elejére helyezzi. Ha a fájl létezik, megszakad. |
| "x+" | Csak írásra és olvasásra nyitott. A fájlmutatót a fájl elejére helyezzi. Ha a fájl létezik, megszakad. |
| "c" | Csak írásra nyitott. A fájlmutatót a fájl elejére helyezzi. Ha a fájl nem létezik, létrehozza azt. Felülírja a fájl tartalmát. |
| "c+" | Csak írásra és olvasásra nyitott. A fájlmutatót a fájl elejére helyezzi. Ha a fájl nem létezik, létrehozza azt. Felülírja a fájl tartalmát. |
BOM bemenet
Ha az írás során a BOM bemenet igaz, akkor a UTF-8 bájtrend-szimbólumot a fájl elejére illeszti. Ez csak akkor történik meg, ha a fájlt felülírják vagy újból létrehozják. Ha a BOM-t nem írták a fájl elejére, akkor később nem lehet hozzáadni.
DONE kimenet
A kimenet siker esetén egy impulzust ad vissza, hogy az következő művelet végrehajtására kerüljön sor. Az impulzus a folyamat befejezésekor történik meg, még akkor is, ha hiba történt.
LENGTH kimenet
A kiírt bájtok számát adja vissza. Az állapot később történő használatra tárolódik el.
ERROR kimenet
Hibás esetben egy szöveget ad vissza, amely tartalmazza a hibajelzést. Ez FALSE, ha nem történt hiba. Az állapot később történő használatra tárolódik el.
Lehetséges okok:
- A tárolóeszköz szolgáltatása nem indult el.
- A tárolót nem inicializálták.
- A bejelentkezési adatok érvénytelenek.
- A távoli szervert nem lehetett elérni.
- A tárolóeszköz nem létezik.
- Az megadott elérési út érvénytelen.
- A tárolóeszközhöz nem írható.
- Nincs több hely a tárolón, vagy a tároló írásvédett.