Leitura e Gravação de Arquivos

Para acessar arquivos reais em um programa de linha de comando, importe dart:io. Ele dá ao Dart a capacidade de ler e gravar no disco.

Um objeto File aponta para um caminho no disco. Criá-lo não abre nem lê nada ainda; ele apenas identifica o destino.

Use readAsString para carregar um arquivo de texto inteiro em uma única cadeia de caracteres. O método retorna um Future, portanto você deve aguardar o resultado.

Prefere uma lista de linhas? readAsLines fornece cada linha como sua própria cadeia de caracteres, ideal para processá-las uma por vez.

Para salvar texto, chame writeAsString. O método cria o arquivo se ele não existir e, por padrão, substitui todo o conteúdo existente.

Quer manter o texto antigo e adicionar mais conteúdo? Passe FileMode.append para que o novo conteúdo seja colocado no final.

Arquivos nem sempre contêm texto. Use readAsBytes para obter os dados brutos como uma lista de inteiros, útil para imagens ou formatos binários.

Ler um arquivo inexistente lança uma exceção. Proteja seu código verificando exists antes de acessar o arquivo.

Todo método assíncrono tem uma versão bloqueante correspondente, como readAsStringSync. É útil em scripts pequenos, mas congela tudo enquanto é executado.

Faça a limpeza com delete ou mova um arquivo chamando rename com um novo caminho. Ambos retornam Futures que você pode aguardar.

Os métodos de texto usam utf8 por padrão. Para outras codificações, informe uma codificação explícita para preservar caracteres acentuados ou especiais.

Você quer adicionar uma linha ao registro sem apagar o conteúdo existente. Qual opção faz isso?

Agora você pode ler arquivos como String, linhas ou bytes, gravar ou adicionar texto e verificar a existência com exists. Esse é o essencial da entrada e saída de arquivos.