Functieblok FS_READ

De functieblok FS_READ leest gegevens uit een bestand.

Let Op: Bij het lezen van zeer grote bestanden kan de SPS of het gehele systeem vastlopen en niet meer worden gestart. Gebruik met voorzichtigheid de ingang LENGTH=0.

Het bestandssysteem moet eerst worden geïnitialiseerd met behulp van FS_INIT. Alle operaties vinden asynchroon plaats per aangemaakt opslagmedium.

Ingang READ

Bij een positieve flank worden de gegevens van het opslagmedium gelezen.

Ingang DEV

Definieert het apparaat waaruit toegang tot bestanden moet worden verkregen. Het apparaat wordt per project gebruikt en kan in het contextmenu onder Project ▸ Extern opslag worden beheerd.

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 OFFSET

Definieert het offset in bytes, vanaf waar moet worden gelezen. Als geen offset is gedefinieerd, wordt vanaf het begin van het bestand gelezen.

Ingang LENGTH

Definieert de maximale lengte totdat het lezen wordt beëindigd. Als de ingang niet is gedefinieerd, wordt er tot aan het einde van het bestand gelezen.

Opmerking: De maximale leesbare grootte bij LENGTH=0 bedraagt uit veiligheidsredenen 1024'000 bytes.

Uitgang DONE

De uitgang geeft bij succes een impuls terug om de volgende operatie uit te voeren. De impuls vindt plaats bij het beëindigen van de taak, zelfs als er een fout is opgetreden.

Uitgang DATA

Geeft de gelezen gegevens terug. De status wordt voor latere gebruik bewaard.

Uitgang EOF

Als het einde van het bestand is bereikt, is de ingang waar.

Uitgang BOM

Als het UTF-8 Byte Order Mark is gevonden, is de uitgang waar. Het BOM wordt bij elke leesoperatie bepaald.

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 is niet gestart.
  • Het opslagmedium is niet geïnitialiseerd.
  • De inloggegevens zijn ongeldig.
  • De externe server kon niet worden bereikt.
  • Het opslagmedium bestaat niet.
  • Het opgegeven pad is ongeldig.