AppendToFile() — MyAthus AthusScript

Adiciona uma linha ao final de um arquivo texto existente. Se o arquivo não existir, ele é criado. O conteúdo é precedido por uma quebra de linha (newline) ao ser adicionado.

Sintaxe

AppendToFile(caminho, conteudo [, encoding])

Parâmetros

Parâmetro	Obrigatório	Descrição
`caminho`	Sim	Caminho completo do arquivo ao qual adicionar conteúdo. Aceita variáveis.
`conteudo`	Sim	Texto a adicionar ao final do arquivo. Sempre precedido por uma quebra de linha. Aceita variáveis e funções.
`encoding`	Não	Codificação do arquivo. Padrão: UTF8. Outros encodings suportados: Ansi, ISO-8859-1, Win-1252, Unicode, UTF-8 wBOM

Exemplos

AthusScript

// Acumular log linha a linha:
AppendToFile(@'C:\logs\execucao.log', FormatDateTime($datetime, 'dd/MM/yyyy HH:mm:ss') + ' - Iniciando...')

// Log de erros em loop:
Foreach ($itens) {
  Try {
    // processa $itens.$Item
  } Catch {
    AppendToFile(@'C:\logs\erros.log', 'ERRO no item ' + $itens.$Item + ': ' + $exception)
  }
}

// Encoding específico:
AppendToFile(@'C:\dados\acumulado.csv', $novaLinha, 'ISO-8859-1')

Observações

Cada chamada adiciona o conteúdo precedido por Environment.NewLine. Para criar um arquivo CSV linha a linha, use AppendToFile() em loop. O arquivo é criado automaticamente se não existir. Use o mesmo encoding em todas as chamadas para o mesmo arquivo para evitar inconsistências.