Lê todo o conteúdo de um arquivo previamente aberto para leitura, utilizando uma codificação de caracteres específica.


Figura 1 - Bloco Ler todo arquivo definindo charset

Compatibilidade

  • Bloco servidor: cronapi.io.Operations.fileReadContentWithCharset()

Retorno

Retorna uma string contendo o conteúdo do arquivo de acordo com a codificação de caracteres selecionada.

Parâmetros

Arquivo aberto para leitura

Objeto que faz referência a um arquivo aberto para leitura. Deve-se utilizar o bloco Abrir arquivo para leitura.

Codificação

Tipo de codificação para leitura do arquivo.

  • Posição: 2
  • Inglês: Charset
  • Tipo: Objeto / Object 
  • Exemplo: "UTF-8"
  • Opções:
    • UTF-8: (8-bit Unicode Transformation Format) é um tipo de codificação binária de comprimento variável pertencente à família Unicode. Ele pode representar qualquer caractere universal padrão do Unicode e é compatível com ASCII.
    • UTF-16: semelhante ao UTF-8, porém, enquanto o UTF-8 pode codificar caracteres utilizando 1 byte (8 bits), o UTF-16 utiliza 2 bytes (16 bits) por caractere.
    • US-ASCII: (Código Padrão Americano para o Intercâmbio de Informação) é um código binário que codifica um conjunto de 128 sinais, incluindo 95 sinais gráficos (letras do alfabeto latino, sinais de pontuação e sinais matemáticos) e 33 sinais de controle. Ele utiliza apenas 7 bits para representar todos os seus símbolos.
    • ISO-8859-1: é um esquema de codificação de um único byte usado para representar o alfabeto latino nº 1, parte da série ISO/IEC 8859 de codificações padrão de caracteres ASCII. O ISO-8859-1 codifica o "alfabeto latino nº 1", consistindo de 191 caracteres.
    • ISO-8859-2: faz parte da mesma família de esquemas de codificação da ISO-8859-1, sendo utilizado principalmente para a maioria das línguas eslavas e centro-europeias de escrita latina, como croata, tcheco, alemão, húngaro, polonês, romeno, eslovaco e esloveno.

Exemplo

A função abaixo apresenta um exemplo de uso do bloco Ler todo arquivo definindo charset. O bloco irá retornar o conteúdo do arquivo informado no bloco com a codificação US-ASCII. O resultado de execução será impresso no console do depurador.


Figura 2 - Exemplo de uso do bloco Ler todo arquivo definindo charset


Na imagem a seguir, podemos visualizar o arquivo utilizado na execução da função.


Figura 2.1 - Arquivo utilizado no exemplo da Figura 2

Nesta página