Bloque de funciones FS_READLINE

El bloque de funciones FS_READLINE lee datos línea por línea desde un archivo.

Atención: Al leer archivos muy grandes, la PLC o todo el sistema puede colapsar y no poder reiniciarse.

Nota: El tamaño máximo legible de una línea es, por razones de seguridad, 1024'000 bytes.

El sistema de archivos debe haber sido inicializado previamente mediante FS_INIT. Todas las operaciones se realizan de manera asíncrona por cada medio de almacenamiento creado.

Entrada READ

Al detectar un flanco positivo, los datos se leen desde el medio de almacenamiento.

Entrada DEV

Define el dispositivo desde el cual se accederá a los archivos. El dispositivo se utiliza por proyecto y puede administrarse en el menú contextual bajo Proyecto ▸ Almacenamiento externo.

Entrada PATH

Especifica la ruta al archivo en el medio de almacenamiento. La ruta corresponde a una ruta de archivo Unix en formato UTF-8, si este es soportado. La ruta se representa de la siguiente manera:

Carpeta/Subcarpeta/Archivo.txt

Entrada LINE

Define la línea que se desea leer. La primera línea comienza con el número 0.

Entrada ENDING

Define el salto de línea. Este se especifica con escapes: "\r\n". Si la entrada no está definida, se asume "\n".

Los siguientes caracteres consideran el escape:

  • "\t" (ASCII 9 (0x09)), un carácter de tabulación.
  • "\n" (ASCII 10 (0x0A)), un avance de línea (Line Feed).
  • "\r" (ASCII 13 (0x0D)), un retorno de carro (Carriage Return).
  • "\0" (ASCII 0 (0x00)), el byte NUL.
  • '\xEF' Forma de escritura para bytes.

Nota: Para que también se puedan definir caracteres binarios, como por ejemplo '\xEF', estos deben definirse entre comillas simples.

Salida DONE

La salida devuelve un pulso en caso de éxito para realizar la siguiente operación. El pulso ocurre al finalizar el proceso, incluso si ha ocurrido un error.

Salida DATA

Devuelve la línea leída, incluyendo el final de línea. El estado se almacena para su uso posterior.

Salida EOF

Si se alcanza el final del archivo, la entrada es verdadera.

Salida BOM

Si se encuentra el Byte Order Mark UTF-8, la salida es verdadera. El BOM se determina en cada operación de lectura.

Salida ERROR

En caso de error, devuelve un texto con un mensaje de error. Este es FALSE si no ha ocurrido ningún error. El estado se almacena para su uso posterior.

Posibles causas:

  • El servicio del medio de almacenamiento no se ha iniciado.
  • La memoria no se ha inicializado.
  • Los datos de inicio de sesión son inválidos.
  • No se pudo alcanzar el servidor remoto.
  • El medio de almacenamiento no existe.
  • La ruta especificada es inválida.