file.getText( )

4D v19.8

file.getText( )


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

Parámetro	Tipo	Descripción
juegoCaract	Texto, Entero largo	Nombre o número de juego de caracteres
modoRetorno	Entero largo	Modo de procesamiento para saltos de línea
Resultado	Texto	Texto del documento

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) los saltos de línea se convierten al formato nativo de la plataforma de ejecución: LF (line feed) en macOS, CRLF (carriage return + line feed) en Windows
Document with CRLF	Entero largo	2	Los saltos de línea se convierten en CRLF (carriage return + line feed), al formato Windows por defecto.
Document with CR	Entero largo	3	Los saltos de líneas se convierten en CR (retorno de carro), el formato Classic Mac OS por defecto.
Document with LF	Entero largo	4	Los saltos de línea se convierten en LF(line feed), al formato Unix y macOS por defecto.

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