Provided by: manpages-fr-dev_3.65d1p1-1_all bug

NOM

       wprintf,  fwprintf,  swprintf,  vwprintf,  vfwprintf,  vswprintf - Formater des chaînes de
       caractères larges

SYNOPSIS

       #include <stdio.h>
       #include <wchar.h>

       int wprintf(const wchar_t *format, ...);
       int fwprintf(FILE *stream, const wchar_t *format, ...);
       int swprintf(wchar_t *wcs, size_t maxlen,
                    const wchar_t *format, ...);

       int vwprintf(const wchar_t *format, va_list args);
       int vfwprintf(FILE *stream, const wchar_t *format, va_list args);
       int vswprintf(wchar_t *wcs, size_t maxlen,
                     const wchar_t *format, va_list args);

   Exigences   de   macros   de   test   de   fonctionnalités   pour    la    glibc    (consultez
   feature_test_macros(7)) :

       Pour toutes les fonctions ci-dessus :
           _XOPEN_SOURCE >= 500 || _ISOC99_SOURCE ||
           _POSIX_C_SOURCE >= 200112L;
           ou cc -std=c99

DESCRIPTION

       La  famille  de  fonctions  wprintf()  est  l'équivalent  pour les caractères larges de la
       famille de fonctions printf(3). Elle réalise une mise en forme des caractères larges.

       Les fonctions wprintf() et vwprintf() réalisent le traitement et la sortie de  chaînes  de
       caractères  larges  sur  stdout.  stdout  ne  doit  pas être orienté caractères (consultez
       fwide(3) pour plus d'informations).

       Les fonctions fwprintf()  et  vfwprintf()  réalisent  la  mise  en  forme  de  chaînes  de
       caractères  larges  en  vue d'une écriture dans le fichier stream. stream ne doit pas être
       orienté caractères (consultez fwide(3) pour plus d'informations).

       Les fonctions swprintf() et vswprintf()  réalisent  la  mise  en  forme  d'une  chaîne  de
       caractères  larges  avant de l'écrire dans un tableau de caractères larges. Le programmeur
       doit s'assurer qu'il y ait assez de place pour au moins maxlen caractères larges dans wcs.

       Ces fonctions se comportent de la même manière que les  fonctions  printf(3),  vprintf(3),
       fprintf(3), vfprintf(3), sprintf(3) et vsprintf(3), hormis les différences suivantes :

       ·      La chaîne format est composée de caractères larges.

       ·      La sortie est faite de caractères larges, pas d'octets.

       ·      swprintf()  et  vswprintf() prennent un argument maxlen, contrairement à sprintf(3)
              et vsprintf(3) (snprintf(3) et vsnprintf(3) prennent un argument maxlen,  mais  ces
              fonctions ne renvoient pas -1 en cas de débordement mémoire sous Linux).

       Le traitement des caractères de conversion c et s est différent :

       c      Si  aucun modificateur l n'est présent, l'argument int est converti en un caractère
              large par un appel à la fonction btowc(3) et le caractère large  en  résultant  est
              écrit.  Si  un  modificateur l est présent, l'argument wint_t (caractère large) est
              écrit.

       s      Si aucun modificateur l n'est présent, l'argument const char * est interprété comme
              un  pointeur  sur  un  tableau de caractères (une chaîne) contenant une séquence de
              caractères larges commençant à l'état  initial.  Les  caractères  du  tableau  sont
              convertis  en  caractères  larges  (un par un par l'appel de la fonction mbrtowc(3)
              avec un état de conversion réinitialisé avant  le  premier  octet).  La  chaîne  de
              caractères larges en résultant est écrite jusqu'au dernier caractère (non compris),
              le caractère nul final (L'\0')). Si la taille est donnée, le nombre  de  caractères
              larges  écrits ne la dépassera pas. Notez bien que la taille détermine le nombre de
              caractères larges écrits et non le nombre d'octets  ou  de  positions  d'écran.  Le
              tableau doit contenir un octet nul final (L'\0'), à moins que la taille donnée soit
              si petite que le nombre de caractères larges est atteint avant la fin  du  tableau.
              Si  un modificateur l est présent : l'argument const wchar_t * est interprété comme
              un pointeur sur un tableau de caractères larges. Les caractères larges  du  tableau
              sont écrits jusqu'au dernier (non compris le caractère nul final). Si la taille est
              indiquée, le nombre de caractères écrits ne  la  dépassera  pas.  Le  tableau  doit
              contenir  un  caractère  nul  final à moins que la taille donnée soit inférieure ou
              égale au nombre de caractères larges du tableau.

VALEUR RENVOYÉE

       Ces fonctions renvoient le nombre de caractères larges écrits, non  compris  le  caractère
       nul  final  dans le cas des fonctions swprintf() et vswprintf(). Elles renvoient -1 en cas
       d'erreur.

CONFORMITÉ

       C99.

NOTES

       Le comportement de wprintf() et compagnie dépend de la catégorie  LC_CTYPE  de  la  locale
       utilisée.

       Si la chaîne format contient des caractères larges non ASCII, le programme ne fonctionnera
       correctement que si la catégorie LC_CTYPE de la localisation lors de  l'exécution  est  la
       même  que  lors  de  la  compilation.  En  effet,  la  représentation de wchar_t dépend de
       l'architecture et de la localisation. La glibc représente les caractères larges  à  l'aide
       de  leurs codes Unicode (ISO-10646), mais les autres architectures ne font pas de même. De
       plus, l'utilisation des noms de caractères universels de  C99  (de  la  forme  \unnnn)  ne
       résout  pas  ce  problème.  Aussi,  la  chaîne  format  ne  devrait être constituée que de
       caractères  larges  dans  les  programmes  internationalisés,  ou  alors  elle  doit  être
       construite à l'exécution de manière internationalisée (en utilisant par exemple gettext(3)
       ou iconv(3), suivi de mbstowcs(3)).

VOIR AUSSI

       fprintf(3), fputwc(3), fwide(3), printf(3), snprintf(3)

COLOPHON

       Cette page fait partie de la publication 3.65 du projet man-pages Linux.  Une  description
       du  projet  et  des  instructions  pour  signaler  des  anomalies  peuvent être trouvées à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis   2010,   cette   traduction   est   maintenue   à   l'aide   de    l'outil    po4a
       <http://po4a.alioth.debian.org/>  par l'équipe de traduction francophone au sein du projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Thierry Vignaud (2002), Alain Portal <http://manpagesfr.free.fr/> (2006). Nicolas François
       et l'équipe francophone de traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>  ou  par  un  rapport  de  bogue   sur   le   paquet
       manpages-fr.

       Vous  pouvez  toujours  avoir  accès  à la version anglaise de ce document en utilisant la
       commande « man -L C <section> <page_de_man> ».