file.getText( )

4D v18

file.getText( )

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( )