Μονάδα Λειτουργίας FS_READLINE

Η Μονάδα Λειτουργίας FS_READLINE διαβάζει δεδομένα γραμμή προς γραμμή από ένα αρχείο.

Προσοχή: Όταν διαβάζετε πολύ μεγάλες αρχείους, η SPS ή ολόκληρο το σύστημα μπορεί να σταματήσει και να μην ξεκινήσει ξανά.

Σημείωση: Το μέγιστο διαβάσιμο μέγεθος μιας γραμμής για λόγους ασφαλείας είναι 1024'000 bytes.

Το σύστημα αρχείων πρέπει να έχει προ-αρχικοποιηθεί με τη βοήθεια του FS_INIT. Όλες οι λειτουργίες πραγματοποιούνται ασύγχρονα για κάθε αποθηκευτικό μέσο που δημιουργείται.

Είσοδος READ

Με μια θετική ακμή, τα δεδομένα διαβάζονται από το αποθηκευτικό μέσο.

Είσοδος DEV

Ορίζει τη συσκευή από την οποία θα γίνει η πρόσβαση στα αρχεία. Η συσκευή χρησιμοποιείται ανά έργο και μπορεί να διαχειριστεί στο μενού Έργο ▸ Εξωτερική Αποθήκευση.

Είσοδος PATH

Ορίζει τη διαδρομή προς το αρχείο στο αποθηκευτικό μέσο. Η διαδρομή αντιστοιχεί σε μια διαδρομή αρχείου Unix στο μορφή UTF-8, εάν υποστηρίζεται. Η διαδρομή παρουσιάζεται ως εξής:

Φάκελος/Υποφάκελος/Αρχείο.txt

Είσοδος LINE

Ορίζει τη γραμμή που πρέπει να διαβαστεί. Η πρώτη γραμμή ξεκινά με τον αριθμό 0.

Είσοδος ENDING

Ορίζει την αλλαγή γραμμής. Αυτό ορίζεται με escapes: "\r\n". Αν η είσοδος δεν οριστεί, τότε υποθέτεται "\n".

Για τα ακόλουθα χαρακτήρες λαμβάνεται υπόψη το escape:

  • "\t" (ASCII 9 (0x09)), ένα χαρακτήρας tab.
  • "\n" (ASCII 10 (0x0A)), μια μετατόπιση γραμμής (Line Feed).
  • "\r" (ASCII 13 (0x0D)), ένα χαρακτήρας επιστροφής αρίθμησης (Carriage Return).
  • "\0" (ASCII 0 (0x00)), το byte NUL.
  • '\xEF' Γραμματική μορφή για bytes.

Σημείωση: Για να μπορούν να οριστούν και δυαδικοί χαρακτήρες, όπως π.χ. '\xEF', πρέπει να ορίζονται σε απλές εισαγωγικές.

Έξοδος DONE

Η έξοδος επιστρέφει έναν παλμό επιτυχίας για να πραγματοποιηθεί η επόμενη λειτουργία. Ο παλμός συμβαίνει στο τέλος της διαδικασίας, ακόμη και αν έχει συμβεί ένα σφάλμα.

Έξοδος DATA

Επιστρέφει τη γραμμή που διαβάζεται, συμπεριλαμβανομένου του τέλους της γραμμής. Η κατάσταση αποθηκεύεται για μελλοντική χρήση.

Έξοδος EOF

Αν έχει φτάσει το τέλος του αρχείου, η είσοδος είναι αληθινή.

Έξοδος BOM

Αν βρεθεί το UTF-8 Byte Order Mark, η έξοδος είναι αληθινή. Το BOM προσδιορίζεται σε κάθε διαδικασία ανάγνωσης.

Έξοδος ERROR

Επιστρέφει έναν κείμενο με ένα μήνυμα σφάλματος σε περίπτωση σφάλματος. Αυτό είναι FALSE, αν δεν έχει συμβεί κάποιο σφάλμα. Η κατάσταση αποθηκεύεται για μελλοντική χρήση.

Δυνατές αιτίες:

  • Η υπηρεσία του αποθηκευτικού μέσου δεν ξεκίνησε.
  • Η μνήμη δεν έχει αρχικοποιηθεί.
  • Τα δεδομένα σύνδεσης είναι άκυρα.
  • Ο απομακρυσμένος διακομιστής δεν μπορεί να επικοινωνήσει.
  • Το αποθηκευτικό μέσο δεν υπάρχει.
  • Η ορισμένη διαδρομή είναι άκυρη.