fichier.setText( )

4D v19.8

fichier.setText( )


fichier.setText ( texte {; jeuCaractères {; modeRetour}} )

Paramètre	Type	Description
texte	Texte	Texte à stocker dans le fichier
jeuCaractères	Texte, Entier long	Nom ou Numéro de jeu de caractères
modeRetour	Entier long	Mode de traitement des retours à la ligne

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" défini sans BOM (sauf en mode compatibilité, voir Page Compatibilité).

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 sauts de ligne sont convertis au format natif de la plate-forme d’exécution : LF (line feed) sous macOS, CRLF (carriage return + line feed) sous Windows
Document with CRLF	Entier long	2	Les sauts de ligne sont convertis en CRLF (carriage return + line feed), au format Windows par défaut.
Document with CR	Entier long	3	Les sauts de ligne sont convertis en CR (carriage return), le format Classic Mac OS par défaut.
Document with LF	Entier long	4	Les sauts de ligne sont convertis en LF (line feed), le format Unix et macOS par défaut.

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