Blok funkcji FS_READLINE

Blok funkcji FS_READLINE odczytuje dane wierszami z pliku.

Uwaga: Przy czytaniu bardzo dużych plików sterownik PLC lub cały system może zawiesić się i nie uruchomić ponownie.

Uwaga: Maksymalny rozmiar odczytu wiersza wynosi z powodów bezpieczeństwa 1024'000 bajtów.

System plików musi być wcześniej zainicjowany za pomocą FS_INIT. Wszystkie operacje są wykonywane asynchronicznie dla każdego utworzonego urządzenia magazynującego.

Wejście READ

Na zboczu rosnącym dane są odczytywane z urządzenia magazynującego.

Wejście DEV

Definiuje urządzenie, z którego należy uzyskać dostęp do plików. Urządzenie jest używane w projekcie i może być zarządzane w menu kontekstowym pod Projekt ▸ Zewnętrzne urządzenie magazynujące.

Wejście PATH

Podaje ścieżkę do pliku na urządzeniu magazynującym. Ścieżka odpowiada ścieżce pliku Unix w formacie UTF-8, jeśli jest on obsługiwany. Ścieżka jest przedstawiana następująco:

Folder/Subfolder/File.txt

Wejście LINE

Definiuje wiersz, który ma być odczytany. Pierwszy wiersz zaczyna się numerem 0.

Wejście ENDING

Definiuje koniec wiersza. Jest on podawany za pomocą escape'ów: "\r\n". Jeśli wejście nie jest zdefiniowane, przyjmuje się "\n".

W przypadku następujących znaków uwzględniany jest escape:

  • "\t" (ASCII 9 (0x09)), znak tabulacji.
  • "\n" (ASCII 10 (0x0A)), przejście do nowego wiersza (Line Feed).
  • "\r" (ASCII 13 (0x0D)), znak powrotu karetki (Carriage Return).
  • "\0" (ASCII 0 (0x00)), bajt NUL.
  • '\xEF' Notacja dla bajtów.

Uwaga: Aby mogły być zdefiniowane również znaki binarne, takie jak np. '\xEF', muszą one być zdefiniowane w pojedynczych cudzysłowach.

Wyjście DONE

Na wyjściu przy sukcesie zwracany jest impuls, aby przeprowadzić kolejną operację. Impuls występuje po zakończeniu procesu, nawet jeśli wystąpił błąd.

Wyjście DATA

Zwraca odczytany wiersz, wraz z końcem wiersza. Stan jest zapisywany dla późniejszego użycia.

Wyjście EOF

Jeśli koniec pliku został osiągnięty, wejście jest prawdziwe.

Wyjście BOM

Jeśli znaleziono znak porządku bajtów UTF-8, wyjście jest prawdziwe. BOM jest określane przy każdej operacji odczytu.

Wyjście ERROR

W przypadku błędu zwraca tekst z komunikatem o błędzie. Jest to FALSE, jeśli nie wystąpił żaden błąd. Stan jest zapisywany dla późniejszego użycia.

Możliwe przyczyny:

  • Usługa urządzenia magazynującego nie została uruchomiona.
  • Pamięć nie została zainicjowana.
  • Dane logowania są nieprawidłowe.
  • Nie można było połączyć się z odległym serwerem.
  • Urządzenie magazynujące nie istnieje.
  • Podana ścieżka jest nieprawidłowa.