file.setText( )

4D v19.8

file.setText( )


file.setText ( texto {; conjCaracteres {; modoRetorno}} )

Parâmetro	Tipo	Descrição
texto	Texto	Texto a armazenar no arquivo
conjCaracteres	Texto, Inteiro longo	Nome ou número do conjunto de caracteres
modoRetorno	Inteiro longo	modo de processamento para os saltos de linha

Descrição

O método file.setText( ) escreve texto como o novo conteúdo de arquivo.

Se o arquivo ao qual se faz referência no objeto File não existir no disco, o método o cria. Quando o arquivo já existir no disco, seu conteúdo anterior é apagado, exceto se já estiver aberto, em cujo caso, seu conteúdo é bloqueado e um erro é gerado.

Em texto, passe o texto a escrever no arquivo. Pode ser um literal ("meu texto"), ou um campo texto ou uma variável 4D.

Em jogoCaract, passe o conjunto de caracteres que se utilizará para escrever o conteúdo. Pode passar uma string que contenha o nome do conjunto de caracteres padrão (por exemplo, “ISO-8859-1” ou “UTF-8”) ou seu ID MEnumum (inteiro longo). Para saber mais sobre a lista de conjuntos de caracteres compatíveis com 4D, consulte a descrição do comando CONVERT FROM TEXT. Se existir um BOM (Byte Order Mark) para o conjunto de caracteres, 4D o insere no arquivo. Se não especificar um conjunto de caracteres, de forma predeterminada, 4D utiliza o conjunto de caracteres "UTF-8" sem BOM (ver Página Compatibilidade).

Em modoRetorno, pode passar um ponto longo que indique o processamento que se aplicará aos caracteres de final de linha antes de salvá-los no arquivo. As constantes abaixo, que são encontradas no tema "Documentos Sistema" estão disponíveis:

Constante	Tipo	Valor	Comentário
Document unchanged	Inteiro longo	0	Sem processamento
Document with native format	Inteiro longo	1	(Por padrão) as linhas de ruptura se convertem ao formato nativo do sistema operativo: CR (retorno de carro) em OS X, CRLF (retorno de carro + salto de linha) em Windows
Document with CRLF	Inteiro longo	2	As linhas de ruptura se convertem ao formato Windows: CRLF (return + salto de linha)
Document with CR	Inteiro longo	3	As linhas de ruptura se convertem ao formato OS X: CR (retorno de carro)
Document with LF	Inteiro longo	4	As linhas de ruptura se convertem ao formato Unix: LF (salto de linha)

De forma pre-determinada, quando omitir o parâmetro modoRetorno, os saltos de linha são processados em modo nativo (1).

Exemplo

 $myFile:=File("C:\\Documents\\Hello.txt";fk platform path)

 $myFile.setText("Hello world")

Ver também

file.getText( )