file.setText( )

4D v19

file.setText( )

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" y un BOM.

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

Ejemplo

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

 $myFile.setText("Hello world")

Ver también

file.getText( )