Cette fonction permet d'effectuer une lecture dans un fichier texte. Le texte est lu depuis la position courante jusqu'au prochain retour chariot.
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 VaToolBxReadString.
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 du fichier. |
ALPHA(n) |
Buffer |
Variable lue par la fonction. |
NUM_BIN_4 |
Taille |
Taille (n) du paramètre 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. 12 Mode binaire strict non supporté. 13 Mode d'ouverture non valide. |
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.
Le mode binaire strict ('i') n'est pas supporté par la fonction.
Par exemple
Alias = 'FichierTexte'
APPELER_DLL 'VATOOLBX.DLL' 'VaToolBxReadString' Alias Buffer Taille CodeRetour
Liste des fonctions de la DLL VaToolBx par thème