fichier.getText( )

4D v19.8

fichier.getText( )


fichier.getText ( {jeuCaractères}{;}{modeRetour} ) -> Résultat

Paramètre	Type	Description
jeuCaractères	Texte, Entier long	Nom ou Numéro du jeu de caractères
modeRetour	Entier long	Mode de traitement des retours à la ligne
Résultat	Texte	Texte du document

Description

La méthode file.getText( ) retourne le contenu du fichier en tant que texte.

Le fichier référencé dans l'objet fichier doit exister sur disque, sinon une erreur est générée.

Dans le paramètre jeuCaractères, passez le jeu de caractères à utiliser pour la lecture 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 le document contient un BOM (Byte Order Mark), 4D utilise le jeu de caractères inséré à la place de celui qui est indiqué dans jeuCaractères (ce paramètres est alors ignoré).

Si le document ne contient pas de BOM et si le paramètre jeuCaractères est omis, 4D utilise par défaut les jeux de caractères "UTF-8".

Dans le paramètre modeRetour, vous pouvez passer un entier long indiquant le traitement à appliquer aux caractères de fin de ligne du document. 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).

Valeur retournée

Texte du fichier.

Exemple

Considérons le document texte suivant (les champs sont séparés par des tabulations ):

id name price vat
3 thé 1.06€ 19.6
2 café 1.05€ 19.6

Lorsque vous exécutez ce code :

 $myFile:=Folder(fk documents folder).file("Billing.txt") //UTF-8 par défaut

 $txt:=$myFile.getText()

... vous obtenez :

  // $Text = "id name price vat\r\n3 thé 1.06€\t19.6\r\n2\tcafé\t1.05€\t19.6"

  // \t = tab

  // \r = CR

Voir aussi

fichier.setText( )