Sous-routine vwsprintf

Editer en ligne

Objectif

Ecrit des caractères larges formatés.

Bibliothèque

Bibliothèque C standard (libc.a)

Syntaxe

#include <wchar.h>
#include <stdarg.h>

int vwsprintf (wcs, Format, arg)
wchar_t * wcs;
const char * Format;
va_list  arg;

Descriptif

La sous-routine Vwsprintf écrit des caractères larges formatés. Il est structuré comme le sous-programme Vsprintf avec quelques différences. Une différence est que le paramètre Wcs spécifie un large tableau de caractères dans lequel la sortie générée doit être écrite, plutôt qu'un tableau de caractères. La seconde différence est que la signification du spécificateur de conversion S est toujours la même dans le cas où l'indicateur # est spécifié. Si la copie a lieu entre des objets qui se chevauchent, le comportement n'est pas défini.

Remarque: Le programmeur doit s'assurer qu'il y a de la place pour au moins maxlen caractères larges dans wcs.

Paramètres

Tableau 1. Paramètres
Article Descriptif
Wcs Indique le tableau des caractères larges dans lesquels la sortie doit être écrite.
Format Spécifie une séquence de caractères multi-octets composée de zéro ou plusieurs directives (caractères multi-octets ordinaires et spécificateurs de conversion). Les nouveaux formats ajoutés pour gérer les caractères larges sont les suivants:
%C
Formate un seul caractère.
%S
Formate une chaîne de caractères larges.
arg Indique les paramètres à imprimer.

Valeurs renvoyées

La sous-routine Vwsprintf renvoie le nombre de caractères larges (non compris le caractère de fin vide) écrits dans le tableau de caractères larges et spécifiés par le paramètre Wcs .