Bloco de Função FS_READLINE

O bloco de função FS_READLINE lê dados linha por linha de um arquivo.

Atenção: Ao ler arquivos muito grandes, o SPS ou todo o sistema pode travar e não poder ser iniciado novamente.

Nota: O tamanho máximo legível de uma linha é, por razões de segurança, 1024'000 bytes.

O sistema de arquivos deve ter sido inicializado anteriormente usando FS_INIT. Todas as operações são realizadas assincronamente por meio de armazenamento criado.

Entrada READ

Na borda positiva, os dados são lidos do meio de armazenamento.

Entrada DEV

Define o dispositivo a partir do qual os arquivos devem ser acessados. O dispositivo é usado por projeto e pode ser gerenciado no menu de contexto sob Projeto ▸ Armazenamento Externo.

Entrada PATH

Especifica o caminho para o arquivo no meio de armazenamento. O caminho corresponde a um caminho de arquivo Unix no formato UTF-8, se este for suportado. O caminho é representado da seguinte forma:

Pasta/Subpasta/Arquivo.txt

Entrada LINE

Define a linha que deve ser lida. A primeira linha começa com o número 0.

Entrada ENDING

Define a quebra de linha. Esta é especificada com escapes: "\r\n". Se a entrada não for definida, assume-se "\n".

Os seguintes caracteres consideram o escape:

  • "\t" (ASCII 9 (0x09)), um caractere de tabulação.
  • "\n" (ASCII 10 (0x0A)), uma quebra de linha (Line Feed).
  • "\r" (ASCII 13 (0x0D)), um caractere de retorno de carro (Carriage Return).
  • "\0" (ASCII 0 (0x00)), o byte NUL.
  • '\xEF' Forma de escrita para bytes.

Nota: Para que caracteres binários, como por exemplo '\xEF', também possam ser definidos, estes devem ser definidos em aspas simples.

Saída DONE

A saída retorna um pulso de sucesso para realizar a próxima operação. O pulso ocorre ao término do processo, mesmo que tenha ocorrido um erro.

Saída DATA

Retorna a linha lida, incluindo o final da linha. O estado é armazenado para uso posterior.

Saída EOF

Se o final do arquivo for alcançado, a entrada é verdadeira.

Saída BOM

Se o UTF-8 Byte Order Mark foi encontrado, a saída é verdadeira. O BOM é determinado em cada operação de leitura.

Saída ERROR

Em caso de erro, retorna um texto com uma mensagem de erro. Este é FALSE, se nenhum erro ocorreu. O estado é armazenado para uso posterior.

Possíveis causas:

  • O serviço do meio de armazenamento não foi iniciado.
  • A memória não foi inicializada.
  • Os dados de login são inválidos.
  • O servidor remoto não pôde ser alcançado.
  • O meio de armazenamento não existe.
  • O caminho especificado é inválido.