Lê um arquivo em um diretório privado de um dispositivo móvel.

Figura 1 - Bloco Ler Arquivo

Por padrão, cada aplicação tem um espaço reservado no armazenamento interno do dispositivo para sua execução e gerenciamento de arquivos. Esse espaço é conhecido como diretório privado.

Compatibilidade

• Bloco cliente mobile: cronapi.cordova.file.readFile()

Retorno

Bloco sem retorno.

Parâmetros

Nome do Arquivo

Nome do arquivo para leitura.

• Posição: 1
• Inglês: File Name
• Tipo: Texto / String
• Exemplo: "meuArquivo.txt"

Sucesso

Executa uma ação caso o diretório seja criado com sucesso.

• Posição: 2
• Inglês: Success
• Tipo: Comando com retorno ("item") / Command with return ("item")
• Exemplo: uso do bloco Exibir Notificação

Erro

Executa uma ação caso ocorra um erro durante a criação do diretório.

• Posição: 3
• Inglês: Error
• Tipo: Comando com retorno ("item") / Command with return ("item")
• Exemplo: uso do bloco Exibir Notificação

Tipo de Retorno

Tipo de retorno do arquivo lido.

• Posição: 4
• Inglês: Return Type
• Tipo: Texto / String
• Exemplo: "DATAURL"
• Opções:
  • ARRAYBUFFER: Lê o conteúdo do arquivo como um objeto ArrayBuffer.
  • TEXT: Lê o conteúdo do arquivo como texto.
  • BINARYSTRING: Lê o conteúdo do arquivo como binário e retorna uma string binária.
  • DATAURL: Lê o conteúdo do arquivo e retorna uma URL de dados (Data URL) codificado em base64.

Exemplo

A função abaixo mostra um exemplo de uso do bloco Ler Arquivo. O bloco Exibir Notificação retornará uma mensagem a depender do resultado da leitura do arquivo. Caso ocorra com sucesso, o fluxo de execução é direcionado para os comandos contidos no parâmetro Sucesso, caso contrário, os comandos em Erro são executados. No parâmetro Tipo de Retorno escolhemos o tipo "ARRAYBUFFERTEXT" <TODO>

<Após os testes, talvez o exemplo mude>

Figura 2 - Exemplo de uso do bloco Ler Arquivo

A imagem a seguir mostra o resultado de execução da função da Figura 2. Após clicar no botão "Ler arquivo", a função será executada <TODO> Na imagem, vemos a notificação exibida após esta ação.

Figura 2.1 - Resultado de execução da função da Figura 2