Bloc Fonctionnel FS_READLINE

Le bloc fonctionnel FS_READLINE lit les données ligne par ligne dans un fichier.

Attention: Lors de la lecture de très grands fichiers, le PLC ou l'ensemble du système peut planter et ne plus démarrer.

Remarque: La taille maximale lisible d'une ligne est de 1024'000 octets pour des raisons de sécurité.

Le système de fichiers doit avoir été initialisé au préalable à l'aide de FS_INIT. Toutes les opérations s'effectuent de manière asynchrone par support de stockage créé.

Entrée READ

Lors d'un front positif, les données sont lues depuis le support de stockage.

Entrée DEV

Définir l'appareil à partir duquel les fichiers doivent être accessibles. L'appareil est utilisé par projet et peut être géré dans le menu contextuel sous Projet ▸ Stockage Externe.

Entrée PATH

Indique le chemin vers le fichier sur le support de stockage. Le chemin correspond à un chemin de fichier Unix au format UTF-8, si celui-ci est pris en charge. Le chemin s'affiche comme suit:

Dossier/Sous-Dossier/Fichier.txt

Entrée LINE

Définir la ligne à lire. La première ligne commence avec le numéro 0.

Entrée ENDING

Définir la fin de ligne. Celle-ci est indiquée par des échappements : "\r\n". Si l'entrée n'est pas définie, alors "\n" est supposé.

Les caractères suivants sont pris en compte avec les échappements:

  • "\t" (ASCII 9 (0x09)), un caractère de tabulation.
  • "\n" (ASCII 10 (0x0A)), une avance de ligne (Line Feed).
  • "\r" (ASCII 13 (0x0D)), un retour chariot (Carriage Return).
  • "\0" (ASCII 0 (0x00)), le byte NUL.
  • '\xEF' Notation pour les octets.

Remarque: Pour que des caractères binaires, tels que '\xEF', puissent être définis, ceux-ci doivent être définis entre simples guillemets.

Sortie DONE

La sortie renvoie un impuls en cas de succès pour effectuer l'opération suivante. L'impuls se produit à la fin du processus, même si une erreur s'est produite.

Sortie DATA

Renvoie la ligne lue, y compris la fin de ligne. L'état est stocké pour une utilisation ultérieure.

Sortie EOF

Si la fin du fichier a été atteinte, l'entrée est vraie.

Sortie BOM

Si le marqueur d'ordre des octets UTF-8 a été trouvé, la sortie est vraie. Le BOM est déterminé à chaque opération de lecture.

Sortie ERROR

En cas d'erreur, renvoie un texte avec un message d'erreur. Celui-ci est FALSE, si aucune erreur ne s'est produite. L'état est stocké pour une utilisation ultérieure.

Causes possibles:

  • Le service du support de stockage n'a pas été démarré.
  • La mémoire n'a pas été initialisée.
  • Les informations d'identification sont invalides.
  • Le serveur distant n'a pas pu être atteint.
  • Le support de stockage n'existe pas.
  • Le chemin spécifié est invalide.