Bloco de Função FS_READ

O bloco de função FS_READ lê dados de um arquivo.

Atenção: Ao ler arquivos muito grandes, a SPS ou todo o sistema pode travar e não poder ser iniciado novamente. Use com cuidado a entrada LENGTH=0.

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

Em uma 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 OFFSET

Define o deslocamento em bytes a partir do qual os dados serão lidos. Se nenhum deslocamento for definido, os dados serão lidos a partir do início do arquivo.

Entrada LENGTH

Define o comprimento máximo até que a leitura seja encerrada. Se a entrada não estiver definida, a leitura será realizada até o final do arquivo.

Nota: O tamanho máximo legível quando LENGTH=0 é de 1.024.000 bytes por razões de segurança.

Saída DONE

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

Saída DATA

Retorna os dados lidos. O estado é armazenado para uso posterior.

Saída EOF

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

Saída BOM

Se a marca de ordem de bytes UTF-8 for encontrada, a saída será 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 tiver ocorrido. O estado é armazenado para uso posterior.

Possíveis causas:

  • O serviço do meio de armazenamento não foi iniciado.
  • O armazenamento não foi inicializado.
  • As credenciais de login são inválidas.
  • O servidor remoto não pôde ser alcançado.
  • O meio de armazenamento não existe.
  • O caminho especificado é inválido.