fichier.getText( )

4D v19

fichier.getText( )

Description

La méthode fichier.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 CONVERTIR DEPUIS TEXTE.

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 inchangé	Entier long	0	Aucun traitement
Document avec format natif	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 avec CRLF	Entier long	2	Les fins de ligne sont convertis au format Windows : CRLF (carriage return + line feed)
Document avec CR	Entier long	3	Les fins de ligne sont convertis au format OS X : CR (carriage return)
Document avec 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).

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:=Dossier(fk dossier documents).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( )