Functieblok FS_WRITE
De functieblok FS_WRITE schrijft gegevens naar een bestandssysteem.
Let Op: Bestaande bestanden worden zonder waarschuwing overschreven.
Het bestandssysteem moet eerst worden geïnitialiseerd met behulp van FS_INIT. Alle operaties vinden asynchroon plaats per aangemaakt opslagmedium.
Ingang WRITE
Bij een positieve flank worden de gegevens naar het opslagmedium geschreven.
Ingang DEV
Definieert het apparaat waaruit toegang tot de bestanden moet worden verkregen. Het apparaat wordt per project gebruikt en kan in het contextmenu onder Project Extern opslag beheerd worden.
Ingang PATH
Geeft het pad naar het bestand op het opslagmedium aan. Het pad komt overeen met een Unix-bestandspad in UTF-8-formaat, indien dit wordt ondersteund. Het pad wordt als volgt weergegeven:
Map/Submap/Bestand.txt
Ingang DATA
Definieert de gegevens die moeten worden geschreven.
Ingang MODE
Geeft de modus aan waarin het bestand moet worden geschreven. Mogelijke modi zijn:
| Modus | Beschrijving |
|---|---|
| "r" | Alleen voor lezen geopend. Plaatst de bestandwijzer op het begin van het bestand. |
| "r+" | Alleen voor lezen en schrijven geopend. Plaatst de bestandwijzer op het begin van het bestand. |
| "w" | Alleen voor schrijven geopend. Plaatst de bestandwijzer op het begin van het bestand. Verwijdert de inhoud van het bestand. Als het bestand niet bestaat, wordt het aangemaakt. |
| "w+" | Alleen voor schrijven en lezen geopend. Plaatst de bestandwijzer op het begin van het bestand. Verwijdert de inhoud van het bestand. Als het bestand niet bestaat, wordt het aangemaakt. |
| "a" | Alleen voor schrijven geopend. Plaatst de bestandwijzer op het einde van het bestand. Als het bestand niet bestaat, wordt het aangemaakt. De gegevens worden aan het einde toegevoegd. |
| "a+" | Alleen voor schrijven en lezen geopend. Plaatst de bestandwijzer op het einde van het bestand. Als het bestand niet bestaat, wordt het aangemaakt. De gegevens worden aan het einde toegevoegd. |
| "x" | Alleen voor schrijven geopend. Plaatst de bestandwijzer op het begin van het bestand. Als het bestand bestaat, wordt de operatie afgebroken. |
| "x+" | Alleen voor schrijven en lezen geopend. Plaatst de bestandwijzer op het begin van het bestand. Als het bestand bestaat, wordt de operatie afgebroken. |
| "c" | Alleen voor schrijven geopend. Plaatst de bestandwijzer op het begin van het bestand. Als het bestand niet bestaat, wordt het aangemaakt. Verwijdert de inhoud van het bestand. |
| "c+" | Alleen voor schrijven en lezen geopend. Plaatst de bestandwijzer op het begin van het bestand. Als het bestand niet bestaat, wordt het aangemaakt. Verwijdert de inhoud van het bestand. |
Ingang BOM
Als de ingang bij het schrijven waar is, wordt het UTF-8 Byte Order Mark aan het begin van het bestand toegevoegd. Dit gebeurt alleen als het bestand overschreven of nieuw aangemaakt wordt. Als het BOM niet aan het begin van het bestand is geschreven, kan dit later niet meer worden toegevoegd.
Uitgang DONE
De uitgang geeft bij succes een impuls terug om de volgende operatie uit te voeren. De impuls vindt plaats bij het beïndigen van de procedure, zelfs als er een fout is opgetreden.
Uitgang LENGTH
Geeft het aantal geschreven bytes terug. De status wordt voor latere gebruik bewaard.
Uitgang ERROR
Geeft in geval van fout een tekst met een foutmelding terug. Deze is FALSE, als er geen fout is opgetreden. De status wordt voor latere gebruik bewaard.
Mogelijke oorzaken:
- De dienst van het opslagmedium werd niet gestart.
- Het opslagmedium werd niet geïnitialiseerd.
- De inloggegevens zijn ongeldig.
- De externe server kon niet worden bereikt.
- Het opslagmedium bestaat niet.
- Het opgegeven pad is ongeldig.
- Er kan niet naar het opslagmedium geschreven worden.
- Geen opslagruimte meer op de opslag of de opslag is beschermd tegen schrijven.