Cette fonction permet d'écrire une chaîne de caractères formatée dans un fichier texte. Le texte est inséré à la position courante du fichier. Cette fonction ajoute un retour chariot après la chaîne.


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 VaToolBxWriteString.


Domaine d'application

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

Texte à écrire par la fonction.

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. 

5     L'écriture ne s'est pas réalisée normalement.

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 texte est encodé en ANSI même si le programme hôte est généré en UNICODE.


En mode 't', le caractère linefeed est toujours remplacé par la séquence carriage return-linefeed.

Génération ANSI  0A -> 0D-0A (si destEnc=ANSI ou UTF-8) ; 0D-00-0A-00 (si destEnc=UTF-16LE) ; 00-0D-00-0A (si destEnc=UTF-16BE...)


Génération Unicode (C) 0A-00 -> 0D-0A (si destEnc=ANSI ou UTF-8) ; 0D-00-0A-00 (si destEnc=UTF-16LE) ; 00-0D-00-0A (si destEnc=UTF-16BE...) .

Le retour chariot ajouté en fin de chaîne est encodé en fonction dans l'encodage choisi dans le mode d'ouverture (ANSI par défaut => ajout d'un carriage-return-linefeed : 0D-0A ; avec un encodage UTF-16LE on aurait : 0D-00-0A-00).


Le mode binaire strict ('i') n'est pas supporté par la fonction.


Par exemple

Alias = 'FichierTexte'

Buffer = 'Texte à ajouter'

APPELER_DLL 'VATOOLBX.DLL' 'VaToolBxWriteString' Alias Buffer CodeRetour


Liste des fonctions de la DLL VaToolBx par thème