Blok funkcji FS_WRITE
Blok funkcji FS_WRITE zapisuje dane do systemu plików.
Uwaga: Istniejące już pliki są bez ostrzeżenia nadpisywane.
System plików musi być wcześniej zainicjowany za pomocą FS_INIT. Wszystkie operacje odbywają się asynchronicznie dla każdego utworzonego medium magazynującego.
Wejście WRITE
W przypadku pozytywnej krawędzi dane są zapisywane na nośniku.
Wejście DEV
Definiuje urządzenie, z którego należy uzyskać dostęp do plików. Urządzenie jest używane w projekcie i może być zarządzane w menu kontekstowym pod Projekt Zewnętrzne Magazynowanie.
Wejście PATH
Podaje ścieżkę do pliku na nośniku. Ścieżka odpowiada ścieżce pliku Unix w formacie UTF-8, jeśli jest to obsługiwane. Ścieżka przedstawia się następująco:
Folder/Subfolder/File.txt
Wejście DATA
Definiuje dane, które mają być zapisane.
Wejście MODE
Podaje tryb, w którym plik ma być zapisany. Możliwe tryby to:
| Tryb | Opis |
|---|---|
| "r" | Otwarty tylko do odczytu. Umieszcza wskaźnik pliku na początku pliku. |
| "r+" | Otwarty tylko do odczytu i zapisu. Umieszcza wskaźnik pliku na początku pliku. |
| "w" | Otwarty tylko do zapisu. Umieszcza wskaźnik pliku na początku pliku. Usuwa zawartość pliku. Jeśli plik nie istnieje, jest tworzony. |
| "w+" | Otwarty tylko do zapisu i odczytu. Umieszcza wskaźnik pliku na początku pliku. Usuwa zawartość pliku. Jeśli plik nie istnieje, jest tworzony. |
| "a" | Otwarty tylko do zapisu. Umieszcza wskaźnik pliku na końcu pliku. Jeśli plik nie istnieje, jest tworzony. Dane są dodawane na końcu. |
| "a+" | Otwarty tylko do zapisu i odczytu. Umieszcza wskaźnik pliku na końcu pliku. Jeśli plik nie istnieje, jest tworzony. Dane są dodawane na końcu. |
| "x" | Otwarty tylko do zapisu. Umieszcza wskaźnik pliku na początku pliku. Jeśli plik istnieje, operacja jest przerywana. |
| "x+" | Otwarty tylko do zapisu i odczytu. Umieszcza wskaźnik pliku na początku pliku. Jeśli plik istnieje, operacja jest przerywana. |
| "c" | Otwarty tylko do zapisu. Umieszcza wskaźnik pliku na początku pliku. Jeśli plik nie istnieje, jest tworzony. Nadpisuje zawartość pliku. |
| "c+" | Otwarty tylko do zapisu i odczytu. Umieszcza wskaźnik pliku na początku pliku. Jeśli plik nie istnieje, jest tworzony. Nadpisuje zawartość pliku. |
Wejście BOM
Jeżeli wejście podczas zapisu jest prawdziwe, to znak porządku bajtów UTF-8 jest dodawany na początku pliku. To dzieje się tylko, gdy plik jest nadpisywany lub tworzony od nowa. Jeśli BOM nie zostało zapisane na początku pliku, nie można tego zrobić później.
Wyjście DONE
Wyjście zwraca impuls w przypadku sukcesu, aby przeprowadzić następną operację. Impuls występuje po zakończeniu procesu, nawet jeśli wystąpił błąd.
Wyjście LENGTH
Zwraca liczbę zapisanych bajtów. Stan jest zapamiętywany do późniejszego użycia.
Wyjście ERROR
W przypadku błędu zwraca tekst z komunikatem o błędzie. Jest to FALSE, jeśli nie wystąpił żaden błąd. Stan jest zapamiętywany do późniejszego użycia.
Możliwe przyczyny:
- Usługa nośnika nie została uruchomiona.
- Magazyn nie został zainicjowany.
- Dane logowania są nieprawidłowe.
- Nie można było połączyć się z odległym serwerem.
- Nośnik nie istnieje.
- Podana ścieżka jest nieprawidłowa.
- Na nośniku nie można zapisać.
- Brak miejsca na magazynie lub magazyn jest chroniony przed zapisem.