Blocco funzionale FS_READLINE

Il blocco funzionale FS_READLINE legge i dati riga per riga da un file.

Attenzione: Quando si leggono file molto grandi, la PLC o l'intero sistema potrebbe bloccarsi e non riavviarsi più.

Nota: La dimensione massima di una riga che può essere letta è, per motivi di sicurezza, 1024'000 byte.

Il sistema di file deve essere stato precedentemente inizializzato tramite FS_INIT. Tutte le operazioni avvengono in modo asincrono per ogni supporto di memoria creato.

Ingresso READ

Su un fronte positivo, i dati vengono letti dal supporto di memoria.

Ingresso DEV

Definisce il dispositivo da cui accedere ai file. Il dispositivo viene utilizzato per progetto e può essere gestito nel menu contestuale sotto Progetto ▸ Memoria esterna.

Ingresso PATH

Specifica il percorso del file sul supporto di memoria. Il percorso corrisponde a un percorso di file Unix in formato UTF-8, se supportato. Il percorso è rappresentato come segue:

Cartella/Sottocartella/File.txt

Ingresso LINE

Definisce la riga da leggere. La prima riga inizia con il numero 0.

Ingresso ENDING

Definisce l'interruzione di riga. Questo viene specificato con escape: "\r\n". Se l'ingresso non è definito, si assume "\n".

I seguenti caratteri considerano l'escape:

  • "\t" (ASCII 9 (0x09)), un carattere di tabulazione.
  • "\n" (ASCII 10 (0x0A)), un avanzamento di riga (Line Feed).
  • "\r" (ASCII 13 (0x0D)), un ritorno carro (Carriage Return).
  • "\0" (ASCII 0 (0x00)), il byte NUL.
  • '\xEF' Forma di scrittura per byte.

Nota: Affinché anche i caratteri binari, come ad esempio '\xEF', possano essere definiti, devono essere definiti tra virgolette singole.

Uscita DONE

L'uscita restituisce un impulso in caso di successo per eseguire la successiva operazione. L'impulso avviene al termine dell'operazione, anche se si è verificato un errore.

Uscita DATA

Restituisce la riga letta, inclusa la fine della riga. Lo stato viene salvato per l'uso successivo.

Uscita EOF

Se è stata raggiunta la fine del file, l'ingresso è vero.

Uscita BOM

Se è stato trovato il Byte Order Mark UTF-8, l'uscita è vera. Il BOM viene determinato ad ogni operazione di lettura.

Uscita ERROR

In caso di errore, restituisce un testo con un messaggio di errore. Questo è FALSE, se non si è verificato alcun errore. Lo stato viene salvato per l'uso successivo.

Possibili cause:

  • Il servizio del supporto di memoria non è stato avviato.
  • La memoria non è stata inizializzata.
  • Le credenziali di accesso non sono valide.
  • Non è possibile raggiungere il server remoto.
  • Il supporto di memoria non esiste.
  • Il percorso specificato non è valido.