Funktionsblok FS_WRITE
Funktionsblokken FS_WRITE skriver data til et filsystem.
Advarsel: Eksisterende filer overskrives uden en advarsel.
Filsystemet skal først initialiseres ved hjælp af FS_INIT. Alle operationer udføres asynkront pr. oprettet lagerenhed.
Indgang WRITE
Når en positiv flanke forekommer, skrives dataene til lagerenheden.
Indgang DEV
Definerer enheden, hvorfra der skal tilgås filerne. Enheden bruges pr. projekt og kan administreres i kontekstmenuen under Projekt Ekstern Lager.
Indgang PATH
Angiver stien til filen på lagerenheden. Stien svarer til en Unix-filsti i UTF-8-format, hvis dette understøttes. Stien vises som følger:
Mappe/Undermappe/Fil.txt
Indgang DATA
Definerer de data, der skal skrives.
Indgang MODE
Angiver tilstanden, hvormed filen skal skrives. Mulige tilstande er:
| Tilstand | Beskrivelse |
|---|---|
| "r" | Kun til læsning åbnet. Placerer filpekeren på filstart. |
| "r+" | Kun til læsning og skrivning åbnet. Placerer filpekeren på filstart. |
| "w" | Kun til skrivning åbnet. Placerer filpekeren på filstart. Sletter indholdet i filen. Hvis filen ikke findes, oprettes den. |
| "w+" | Kun til skrivning og læsning åbnet. Placerer filpekeren på filstart. Sletter indholdet i filen. Hvis filen ikke findes, oprettes den. |
| "a" | Kun til skrivning åbnet. Placerer filpekeren på filslutningen. Hvis filen ikke findes, oprettes den. Dataene tilføjes i slutningen. |
| "a+" | Kun til skrivning og læsning åbnet. Placerer filpekeren på filslutningen. Hvis filen ikke findes, oprettes den. Dataene tilføjes i slutningen. |
| "x" | Kun til skrivning åbnet. Placerer filpekeren på filstart. Hvis filen findes, afbrydes. |
| "x+" | Kun til skrivning og læsning åbnet. Placerer filpekeren på filstart. Hvis filen findes, afbrydes. |
| "c" | Kun til skrivning åbnet. Placerer filpekeren på filstart. Hvis filen ikke findes, oprettes den. Overskriver indholdet i filen. |
| "c+" | Kun til skrivning og læsning åbnet. Placerer filpekeren på filstart. Hvis filen ikke findes, oprettes den. Overskriver indholdet i filen. |
Indgang BOM
Hvis indgangen er sand ved skrivning, tilføjes UTF-8 Byte Order Mark i begyndelsen af filen. Dette sker kun, hvis filen overskrives eller oprettes på ny. Hvis BOM ikke blev skrevet i begyndelsen af filen, kan det ikke tilføjes senere.
Udgang DONE
Udgangen returnerer ved succes en impuls for at udføre den næste operation. Impulsen opstår ved afslutningen af processen, også hvis der er opstået en fejl.
Udgang LENGTH
Returnerer antallet af skrevet bytes. Tilstanden gemmes til senere brug.
Udgang ERROR
Returnerer ved fejl en tekst med en fejlbesked. Denne er FALSE, hvis der ikke er opstået nogen fejl. Tilstanden gemmes til senere brug.
Mulige årsager:
- Tjenesten for lagerenheden blev ikke startet.
- Lagret blev ikke initialiseret.
- Logindataene er ugyldige.
- Den fjernede server kunne ikke nås.
- Lagerenheden findes ikke.
- Den angivne sti er ugyldig.
- Der kan ikke skrives til lagerenheden.
- Der er ingen plads tilbage på lagret eller lagret er skrivebeskyttet.