file.getText( )

4D v19.8

file.getText( )


file.getText ( {conjCaracteres}{;}{modoRetorno} ) -> Resultado

Parâmetro	Tipo	Descrição
conjCaracteres	Texto, Inteiro longo	Nome ou número de conjunto de caracteres
modoRetorno	Inteiro longo	Modo de processamento de saltos de linhas
Resultado	Texto	Texto do documento

Descrição

O método file.getText( ) devolve o conteúdo de arquivo como texto.

O arquivo ao qual faz referência no objeto file deve existir no disco, do contrário se gera um erro.

No parâmetro conjCaract, passe o conjunto de caracteres que se utilizará para ler o conteúdo. Pode passar uma string que contenha o nome padrão do conjunto (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 o documento conter uma BOM (Byte Order Mark), 4D utiliza o conjunto de caracteres que foi definido ao invés do especificado em conjCaract (este parâmetro é ignorado).

Se o documento não conter um BOM e se for omitido o parâmetro conjCaract, como padrão 4D utiliza os conjuntos de caracteres "UTF-8".

Em modoRetorno, pode passar um inteiro longo que indique o processamento que se aplicará aos caracteres de final de linha no documento. As constantes abaixo do 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).

Valor devolvido

Texto de arquivo.

Exemplo

Dado o documento de texto abaixo (os campos estão separados por tabulações):

id name price vat
3 thé 1.06€ 19.6
2 café 1.05€ 19.6

Quando executar este código:

 $myFile:=Folder(fk documents folder).file("Billing.txt") //UTF-8 por padrão

 $txt:=$myFile.getText()

...obtém:

  // $Text = "id name price vat\r\n3 thé 1.06€\t19.6\r\n2\tcafé\t1.05€\t19.6"

  // \t = tab

  // \r = CR

Ver também

file.setText( )