fichier.setText( )

4D v19

fichier.setText( )

Description

La méthode file.setText( ) écrit texte comme nouveau contenu du fichier.

Si le fichier référencé dans l'objet File n'existe pas sur disque, il est créé par la méthode. Lorsque le fichier existe déjà sur disque, son contenu antérieur est supprimé, sauf s'il est déjà ouvert, auquel cas son contenu est verrouillé et une erreur est générée.

Dans le paramètre texte, passez le texte à écrire dans le fichier. Il peut être littéral ("my text"), un champ texte ou une variable 4D.

Dans le paramètre jeuCaractères, passez le jeu de caractères à utiliser pour l'écriture du contenu. Vous pouvez passer une chaîne contenant le nom standard du jeu (par exemple “ISO-8859-1” ou “UTF-8”) ou son identifiant MIBEnum (entier long). Pour plus d'informations sur la liste des jeux de caractères pris en charge par 4D, veuillez vous reporter à la description de la commande CONVERT FROM TEXT. Si un BOM (Byte Order Mark) existe pour le jeu de caractères, 4D l'insère dans le fichier. Si vous n'indiquez pas un jeu de caractères, 4D utilise par défaut le jeu de caractères "UTF-8" et un BOM.

Dans le paramètre modeRetour, vous pouvez passer un entier long indiquant le traitement à appliquer aux caractères de fin de ligne avant de les sauvegarder dans le fichier. Les constantes suivantes du thème "Documents système" sont disponibles :

Constante	Type	Valeur	Comment
Document unchanged	Entier long	0	Aucun traitement
Document with native format	Entier long	1	(Défaut) Les fins de ligne sont convertis au format natif de la plate-forme d’exécution : CR (carriage return) sous OS X, CRLF (carriage return + line feed) sous Windows
Document with CRLF	Entier long	2	Les fins de ligne sont convertis au format Windows : CRLF (carriage return + line feed)
Document with CR	Entier long	3	Les fins de ligne sont convertis au format OS X : CR (carriage return)
Document with LF	Entier long	4	Les fins de ligne sont convertis au format Unix : LF (line feed)

Par défaut, lorsque vous omettez le paramètre modeRetour, les retours à la ligne sont traités en mode natif (1).

Exemple

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

 $myFile.setText("Hello world")

Voir aussi

fichier.getText( )