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