Toimintosarja FS_READLINE

Toimintosarja FS_READLINE lukee tiedoston riveittäin.

Huomio: Suurten tiedostojen lukeminen voi aiheuttaa SPS:n tai koko järjestelmän kaatumisen eikä sitä enää voida käynnistää.

Huomautus: Turvallisuussyistä rivin maksimikoko on 1024'000 tavua.

Tiedostojärjestelmän tulee olla alustettu aiemmin FS_INIT-toiminnolla. Kaikki operaatiot suoritetaan asynkronisesti jokaiselle luodulle tallennusvälineelle.

Syöttö READ

Positiivisella reuna-arvolla tiedot luetaan tallennusvälineeltä.

Syöttö DEV

Määrittää laitteen, josta tiedostoihin pääsy on mahdollista. Laite määritetään projektin kohteena ja sitä voidaan hallita kontekstivalikosta Projekti ▸ Ulkoinen tallennus.

Syöttö PATH

Määrittää tiedoston polun tallennusvälineellä. Polku vastaa Unix-tiedostopolkua UTF-8-muodossa, jos se on tuettu. Polku esitetään seuraavasti:

Kansio/Alikansio/Tiedosto.txt

Syöttö LINE

Määrittää rivin, joka tulee lukea. Ensimmäinen rivi alkaa numerosta 0.

Syöttö ENDING

Määrittää rivinvaihdon. Se annetaan escape-merkein: "\r\n". Jos syötettä ei määritetä, oletuksena on "\n".

Seuraavilla merkeillä escape otetaan huomioon:

  • "\t" (ASCII 9 (0x09)), tabulaattori.
  • "\n" (ASCII 10 (0x0A)), rivinvaihto (Line Feed).
  • "\r" (ASCII 13 (0x0D)), vaaka-alustusmerkki (Carriage Return).
  • "\0" (ASCII 0 (0x00)), NUL-tavumerkki.
  • '\xEF' Tavumerkkien kirjoitusmuoto.

Huomautus: Jotta myös binääritiedot, kuten esimerkiksi '\xEF', voidaan määrittää, ne on määritettävä yksinkertaisissa lainausmerkeissä.

Tulo DONE

Tulosta palauttaa menestyksen tapauksessa impulssin seuraavan operaation suorittamiseksi. Impulssi tapahtuu prosessin päättyessä, myös jos virhe on ilmennyt.

Tulo DATA

Palauttaa luetun rivin, mukaan lukien rivinpääte. Tila tallennetaan myöhemmin käytettäväksi.

Tulo EOF

Jos tiedoston loppu on saavutettu, syöttö on totta.

Tulo BOM

Jos UTF-8 Byte Order Mark löytyy, tulo on totta. BOM määritetään jokaisessa lukuvaiheessa.

Tulo ERROR

Palauttaa virhetapauksessa tekstin virheilmoituksella. Se on FALSE, jos virhettä ei ole tapahtunut. Tila tallennetaan myöhemmin käytettäväksi.

Mahdolliset syyt:

  • Tallennusvälineen palvelu ei ole käynnistetty.
  • Tallennus ei ole alustettu.
  • Kirjauduttamisen tiedot ovat virheellisiä.
  • Etäpalvelinta ei voitu saavuttaa.
  • Tallennusvälinettä ei ole olemassa.
  • Määritetty polku on virheellinen.