Bloc funcțional FS_WRITE
Blocul funcțional FS_WRITE scrie date pe un sistem de fișiere.
Atenție: Fișierele existente sunt suprascrise fără un avertisment.
Sistemul de fișiere trebuie inițializat anterior prin intermediul FS_INIT. Toate operațiile se efectuează asincron pentru fiecare mediu de stocare creat.
Intrarea WRITE
La o frontieră pozitivă, datele sunt scrise pe mediu de stocare.
Intrarea DEV
Defineste dispozitivul de unde se poate accesa fișierele. Dispozitivul este utilizat pe proiect și poate fi gestionat în meniul contextual sub Proiect Stocare Externă.
Intrarea PATH
Specifică calea către fișier pe mediu de stocare. Calea corespunde unui Unix file path în format UTF-8, dacă acesta este suportat. Calea este reprezentată astfel:
Folder/Subfolder/Fisier.txt
Intrarea DATA
Defineste datele care trebuie scrise.
Intrarea MODE
Specifică modul în care fișierul trebuie scris. Modurile posibile sunt:
| Mod | Descriere |
|---|---|
| "r" | Deschis doar pentru citire. Plasează indicatorul de fișier la începutul fișierului. |
| "r+" | Deschis doar pentru citire și scriere. Plasează indicatorul de fișier la începutul fișierului. |
| "w" | Deschis doar pentru scriere. Plasează indicatorul de fișier la începutul fișierului. Șterge conținutul fișierului. Dacă fișierul nu există, acesta este creat. |
| "w+" | Deschis doar pentru scriere și citire. Plasează indicatorul de fișier la începutul fișierului. Șterge conținutul fișierului. Dacă fișierul nu există, acesta este creat. |
| "a" | Deschis doar pentru scriere. Plasează indicatorul de fișier la sfârșitul fișierului. Dacă fișierul nu există, acesta este creat. Datele sunt adăugate la sfârșit. |
| "a+" | Deschis doar pentru scriere și citire. Plasează indicatorul de fișier la sfârșitul fișierului. Dacă fișierul nu există, acesta este creat. Datele sunt adăugate la sfârșit. |
| "x" | Deschis doar pentru scriere. Plasează indicatorul de fișier la începutul fișierului. Dacă fișierul există, operația este întreruptă. |
| "x+" | Deschis doar pentru scriere și citire. Plasează indicatorul de fișier la începutul fișierului. Dacă fișierul există, operația este întreruptă. |
| "c" | Deschis doar pentru scriere. Plasează indicatorul de fișier la începutul fișierului. Dacă fișierul nu există, acesta este creat. Suprascrie conținutul fișierului. |
| "c+" | Deschis doar pentru scriere și citire. Plasează indicatorul de fișier la începutul fișierului. Dacă fișierul nu există, acesta este creat. Suprascrie conținutul fișierului. |
Intrarea BOM
Dacă intrarea este adevărată la scriere, atunci UTF-8 Byte Order Mark este adăugat la începutul fișierului. Acest lucru se întâmplă doar dacă fișierul este suprascris sau creat nou. Dacă BOM nu a fost scris la începutul fișierului, acesta nu poate fi adăugat ulterior.
Ieșirea DONE
Ieșirea returnează un impuls de succes pentru a efectua următoarea operație. Impulsul are loc la încheierea procesului, chiar dacă a apărut o eroare.
Ieșirea LENGTH
Returnează numărul de octeți scrise. Starea este salvată pentru utilizare ulterioară.
Ieșirea ERROR
Returnează un text cu o mesaj de eroare în caz de eroare. Acesta este FALSE, dacă nu a apărut nicio eroare. Starea este salvată pentru utilizare ulterioară.
Cauze posibile:
- Serviciul mediu de stocare nu a fost pornit.
- Memoria nu a fost inițializată.
- Datele de conectare sunt invalide.
- Serverul îndepărtat nu a putut fi contactat.
- Mediu de stocare nu există.
- Calea specificată este invalidă.
- Nu se poate scrie pe mediu de stocare.
- Nu mai este spațiu de stocare sau memoria este protejată împotriva scrierii.