4D v14.3

Document vers texte

Accueil

 
4D v14.3
Document vers texte

Document vers texte 


 

Document vers texte ( nomFichier {; jeuCaractères {; modeRetour}} ) -> Résultat 
Paramètre Type   Description
nomFichier  Chaîne in Nom de document ou Chemin d'accès à un document
jeuCaractères  Texte, Entier long in Nom ou Numéro de jeu de caractères
modeRetour  Entier long in Mode de traitement des retours à la ligne
Résultat  Texte in Texte issu du document

La commande Document vers texte permet de récupérer directement le contenu d’un fichier sur disque dans une variable texte ou un champ texte 4D.

Passez dans nomFichier le nom ou le chemin d’accès du fichier à lire. Le fichier doit exister sur le disque, sinon une erreur est générée. Vous pouvez passer :

  • uniquement le nom du fichier, par exemple "monFichier.txt" : dans ce cas, le fichier doit se trouver à côté du fichier de structure de l’application.
  • un chemin d’accès relatif au fichier de structure de l’application, par exemple "\\docs\\monFichier.txt" sous Windows ou ":docs:monFichier.txt" sous OS X.
  • un chemin d’accès absolu, par exemple "c:\\app\\docs\\monFichier.txt" sous Windows ou "MacHD:docs:monFichier.txt" sous OS X.

Vous pouvez passer dans jeuCaractères le jeu de caractères à utiliser pour la lecture. 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, reportez-vous à la description de la commande CONVERTIR DEPUIS TEXTE.

Si le document contient une BOM (Byte Order Mark), 4D utilise le jeu de caractères qu’elle définit au lieu du jeu de caractères spécifié dans jeuCaractères (ce paramètre 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 suivants :

  • sous Windows : ANSI
  • sous OS X : MacRoman

Vous pouvez passer dans modeRetour un entier long indiquant le traitement à effectuer sur les caractères de fin de ligne présents dans le document. Vous pouvez utiliser une des constantes suivantes, placées dans le thème "Documents système" :

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

Par défaut, si le paramètre modeRetour est omis, les caractères de fin de ligne sont traités en mode natif (1).

Note : Cette commande ne modifie pas la variable OK. En cas d’échec, une erreur est générée, que vous pouvez intercepter à l’aide d’une méthode installées par la commande APPELER SUR ERREUR.

Exemple  

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

id    name    price    vat
3    4D Tags    99    19,6

Si vous exécutez ce code :

 $Text:=Document vers texte("products.txt")

... vous obtenez :

  // $Text = "id\tname\tprice\tvat\r\n3\t4D Tags\t99 \t19,6"
  // \t = tabulation
  // \r = CR

 
PROPRIÉTÉS 

Produit : 4D
Thème : Documents système
Numéro : 1236
Nom intl. : Document to text

 
HISTORIQUE 

New
Créé : 4D v14

 
VOIR AUSSI  

Documents système
TEXTE VERS DOCUMENT

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)