Toimintosarja FS_READ
Toimintosarja FS_READ lukee tietoja tiedostosta.
Huomio: Suurten tiedostojen lukeminen voi aiheuttaa SPS:n tai koko järjestelmän kaatumisen, eikä sitä enää voida käynnistää. Käytä LENGTH=0 -syötettä varovaisesti.
Tiedostojärjestelmän on oltava aiemmin alustettu FS_INIT-toiminnolla. Kaikki operaatiot suoritetaan asynkronisesti jokaiselle luodulle tallennusvälineelle.
Syöte READ
Positiivisen reunan kohdalla tallennusvälineeltä luetaan tiedot.
Syöte DEV
Määrittää laitteen, josta tiedostoihin halutaan päästä käsiksi. Laite on projektikohtainen ja sitä voidaan hallita kontekstivalikosta Projekti Ulkoinen tallennus.
Syöte PATH
Määrittää tiedoston polun tallennusvälineellä. Polku vastaa Unix-tiedostopolkua UTF-8-muodossa, jos tätä tuetaan. Polku esitetään seuraavasti:
Kansio/Alikansio/Tiedosto.txt
Syöte OFFSET
Määrittää tavutason offsetin, josta lukeminen aloitetaan. Jos offsettia ei ole määritetty, lukeminen aloitetaan tiedoston alkupäästä.
Syöte LENGTH
Määrittää maksimipituuden, kunnes lukeminen lopetetaan. Jos syötettä ei ole määritetty, lukeminen jatkuu tiedoston loppuun saakka.
Huomio: LENGTH=0-tilassa maksimi luettava koko on turvallisuussyistä 1024'000 tavua.
Tulo DONE
Tulosta palautetaan menestyksellisesti impulssi seuraavan operaation suorittamiseksi. Impulssi tapahtuu prosessin päättyessä, myös jos virhe on ilmennyt.
Tulo DATA
Palauttaa luetut tiedot. Tila tallennetaan myöhemmin käytettäväksi.
Tulo EOF
Jos tiedoston loppu on saavutettu, syöte on tosi.
Tulo BOM
Jos UTF-8 Byte Order Mark löytyy, tulo on tosi. BOM määritetään jokaisessa lukemisoperaatiossa.
Tulo ERROR
Virhetapauksessa palauttaa tekstin virheilmoituksella. 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.
- Kirjauduttamisen tiedot ovat virheellisiä.
- Etäpalvelimeen ei voi päästä käsiksi.
- Tallennusvälinettä ei ole olemassa.
- Määritetty polku on virheellinen.