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
