file.setText( )

4D v19.8

file.setText( )


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

Parámetro	Tipo	Descripción
texto	Texto	Texto a almacenar en el archivo
juegoCaract	Texto, Entero largo	Nombre o número de juego de caracteres
modoRetorno	Entero largo	Modo de procesamiento para saltos de línea

Descripción

El método file.setText( ) escribe texto como el nuevo contenido del archivo.

Si el archivo al que se hace referencia en el objeto File no existe en el disco, el método lo crea. Cuando el archivo ya existe en el disco, su contenido anterior se borra, excepto si ya está abierto, en cuyo caso, su contenido se bloquea y se genera un error.

En texto, pase el texto a escribir en el archivo. Puede ser un literal ("mi texto"), o un campo texto o una variable 4D.

En juegoCaract, pase el conjunto de caracteres que se utilizará para escribir el contenido. Puede pasar una cadena que contenga el nombre del conjunto de caracteres estándar (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 existe un BOM (Byte Order Mark) para el conjunto de caracteres, 4D lo inserta en el archivo. Si no especifica un conjunto de caracteres, de forma predeterminada, 4D utiliza el conjunto de caracteres "UTF-8" sin BOM (excepto en modo compatibilidad, ver Página Compatibilidad).

En modoRetorno, puede pasar un punto largo que indique el procesamiento que se aplicará a los caracteres de fin de línea antes de guardarlos en el archivo. Las siguientes constantes, que se encuentran en el 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).

Ejemplo

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

 $myFile.setText("Hello world")

Ver también

file.getText( )