Toimintosarja FS_WRITE
Toimintosarja FS_WRITE kirjoittaa tiedot tiedostojärjestelmään.
Huomio: Jos tiedosto on jo olemassa, se korvataan ilman varoitusta.
Tiedostojärjestelmän tulee olla alustettu aiemmin FS_INIT-toiminnolla. Kaikki operaatiot suoritetaan asynkronisesti jokaiselle luodulle tallennusvälineelle.
Syöttö WRITE
Positiivisen reunan kohdalla tiedot kirjoitetaan tallennusvälineelle.
Syöttö DEV
Määrittää laitteen, josta tiedostoihin halutaan päästä käsiksi. Laite käytetään projektissa ja sitä voidaan hallita kontekstivalikosta Projekti Ulkoinen tallennus.
Syöttö PATH
Määrittää polun tiedostoon tallennusvälineellä. Polku vastaa Unix-tiedostopolkua UTF-8-muodossa, jos tämä on tuettu. Polku esitetään seuraavasti:
Kansio/Alikansio/Tiedosto.txt
Syöttö DATA
Määrittää tiedot, jotka halutaan kirjoittaa.
Syöttö MODE
Määrittää tilan, jolla tiedosto halutaan kirjoittaa. Mahdolliset tilat ovat:
| Tila | Kuvaus |
|---|---|
| "r" | Ainoastaan lukemista varten avattu. Sijoittaa tiedostemerkin tiedoston alkuun. |
| "r+" | Ainoastaan lukemista ja kirjoittamista varten avattu. Sijoittaa tiedostemerkin tiedoston alkuun. |
| "w" | Ainoastaan kirjoittamista varten avattu. Sijoittaa tiedostemerkin tiedoston alkuun. Tyhjentää tiedoston sisällön. Jos tiedostoa ei ole olemassa, se luodaan. |
| "w+" | Ainoastaan kirjoittamista ja lukemista varten avattu. Sijoittaa tiedostemerkin tiedoston alkuun. Tyhjentää tiedoston sisällön. Jos tiedostoa ei ole olemassa, se luodaan. |
| "a" | Ainoastaan kirjoittamista varten avattu. Sijoittaa tiedostemerkin tiedoston loppuun. Jos tiedostoa ei ole olemassa, se luodaan. Tiedot lisätään loppuun. |
| "a+" | Ainoastaan kirjoittamista ja lukemista varten avattu. Sijoittaa tiedostemerkin tiedoston loppuun. Jos tiedostoa ei ole olemassa, se luodaan. Tiedot lisätään loppuun. |
| "x" | Ainoastaan kirjoittamista varten avattu. Sijoittaa tiedostemerkin tiedoston alkuun. Jos tiedosto on olemassa, toiminto keskeytetään. |
| "x+" | Ainoastaan kirjoittamista ja lukemista varten avattu. Sijoittaa tiedostomerkin tiedoston alkuun. Jos tiedosto on olemassa, toiminto keskeytetään. |
| "c" | Ainoastaan kirjoittamista varten avattu. Sijoittaa tiedostemerkin tiedoston alkuun. Jos tiedostoa ei ole olemassa, se luodaan. Ylikirjoittaa tiedoston sisällön. |
| "c+" | Ainoastaan kirjoittamista ja lukemista varten avattu. Sijoittaa tiedostemerkin tiedoston alkuun. Jos tiedostoa ei ole olemassa, se luodaan. Ylikirjoittaa tiedoston sisällön. |
Syöttö BOM
Jos syöttö on kirjoittamisen aikana tosi, UTF-8-tietojärjestysmerkki lisätään tiedoston alkuun. Tämä tapahtuu vain, jos tiedosto ylikirjoitetaan tai luodaan uudelleen. Jos tietojärjestysmerkkiä ei ole kirjoitettu tiedoston alkuun, sitä ei voi lisätä jälkikäteen.
Tulo DONE
Tulon palauttaa onnistumisen yhteydessä impulssin seuraavan operaation suorittamiseksi. Impulssi tapahtuu toiminnon päättymisen yhteydessä, myös jos virhe on tapahtunut.
Tulo LENGTH
Palauttaa kirjoitettujen tavujen määrän. Tila tallennetaan myöhemmin käytettäväksi.
Tulo ERROR
Virhetapauksessa palauttaa tekstin, jossa on virheilmoitus. Tämä on FALSE, jos virhettä ei ole tapahtunut. Tila tallennetaan myöhemmin käytettäväksi.
Mahdolliset syyt:
- Tallennusvälineen palvelu ei ole käynnistetty.
- Tallennusta ei ole alustettu.
- Kirjautumistiedot ovat virheellisiä.
- Etäpalvelinta ei voitu saavuttaa.
- Tallennusvälinettä ei ole olemassa.
- Määritetty polku on virheellinen.
- Tallennusvälineelle ei voi kirjoittaa.
- Ei enää tallennustilaa tai tallennus on suojattu kirjoituksilta.