Téléchargement des produits


Version anglaise


 

 

Cette fonction permet d'effectuer une lecture dans un fichier texte.

 

Important : pour un alias donné, la dll VaToolBx doit être déjà chargée (ordre CHARGER_DLL) au moment de l'appel de la fonction VaToolBxOpenFile, et doit rester chargée au moment de l'appel de la fonction VaToolBxReadFile.

 

Domaine d'application

  • Client Windows,

  • Serveur Windows,

  • Client Mobile,

  • Serveur Mobile,

  • Client Java,

  • Serveur Java,

  • Client Adélia Web,

  • Client Adélia Cloud.

Remarque : la gestion de l'encodage et le mode 'i' ne sont pas pris en compte en génération mobile.

 

Paramètres

ALPHA(n)

Alias

Nom logique du fichier à ouvrir.

ALPHA(n)

Buffer

Variable résultante de la lecture.

NUM_BIN_4

Taille

En entrée, nombre de caractères (mode't' ou 'b') ou octets (mode'i') à lire dans le fichier. Taille doit être inférieure ou égale à la taille n du Buffer (ou à n x 2 pour le mode 'i' en génération C/UNICODE, Java).

En sortie, la fonction modifie cette valeur en indiquant le nombre de caractères (mode 't' ou 'b') ou octets (mode 'i') effectivement lus et contenus dans le Buffer.

NUM_BIN_4

CodeRetour

Code retour de l'opération :

0    L'opération s'est déroulée correctement. 

2    L'alias n'est pas défini. 

4    Le fichier n'a pu être lu. 

6    Fin de fichier atteinte.

11  Erreur lors de la conversion des caractères.

 

Remarques :

Par défaut (mode 't' ou 'b'), si aucun encodage n'est précisé dans le mode d'ouverture du fichier, alors le fichier est lu avec un encodage ANSI même si le programme hôte est généré en UNICODE.

A contrario, si un encodage est précisé, alors :

  • si le fichier lu contient une BOM, l'encodage utilisé est celui de la BOM.
  • si le fichier lu ne contient pas de BOM, l'encodage utilisé est celui précisé dans le mode d'ouverture.

 

En mode 't', le caractère carriage return précédant un caractère linefeed est systématiquement supprimé.

 

Par exemple

Alias = 'FichierTexte'

Taille = n

APPELER_DLL 'VATOOLBX.DLL' 'VaToolBxReadFile' Alias Buffer Taille CodeRetour

 

Liste des fonctions de la DLL VaToolBx par thème

↑ Haut de page

  • Aucune étiquette