file.getText( )

4D v19

file.getText( )

Descripción

El método file.getText( ) devuelve el contenido del archivo como texto.

El archivo al que se hace referencia en el objeto file debe existir en el disco, de lo contrario se genera un error.

En el parámetro juegoCaract, pase el conjunto de caracteres que se utilizará para leer el contenido. Puede pasar una cadena que contenga el nombre estándar del conjunto (por ejemplo, "ISO-8859-1" o "UTF-8") o su ID MEnumum (entero largo). Para más información sobre la lista de juegos de caracteres compatibles con 4D, consulte la descripción del comando CONVERT FROM TEXT.

Si el documento contiene una BOM (Byte Order Mark), 4D utiliza el conjunto de caracteres que ha definido en lugar del especificado en juegoCaract (este parámetro se ignora).

Si el documento no contiene un BOM y si se omite el parámetro juegoCaract, por defecto 4D utiliza los juegos de caracteres "UTF-8".

En modoRetorno, puede pasar un entero largo que indique el procesamiento que se aplicará a los caracteres de fin de línea en el documento. Las siguientes constantes del tema "Documentos sistema" están disponibles:

Constante	Tipo	Valor	Comentario
Document unchanged	Entero largo	0	Ningún proceso
Document with native format	Entero largo	1	(Por defecto) las líneas de ruptura se convierten al formato nativo del sistema operativo: CR (retorno de carro) en OS X, CRLF (retorno de carro + salto de línea) en Windows
Document with CRLF	Entero largo	2	Las líneas de ruptura se convierten al formato Windows: CRLF (retorno de carro + salto de línea)
Document with CR	Entero largo	3	Las líneas de ruptura se convierten al formato OS X: CR (retorno de carro)
Document with LF	Entero largo	4	Las líneas de ruptura se convierten al formato Unix: LF (salto de línea)

De forma predeterminada, cuando omite el parámetro modoRetorno, los saltos de línea se procesan en modo nativo (1).

Valor devuelto

Texto del archivo.

Ejemplo

Dado el siguiente documento de texto (los campos están separados por pestañas):

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

Cuando ejecuta este código:

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

 $txt:=$myFile.getText()

...obtiene:

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

  // \t = tab

  // \r = CR

Ver también

file.setText( )