Loading

NOM

       wcstombs  -  Convertir  une  chaîne  de caractères étendus en chaîne de
       caractères multioctet

SYNOPSIS

       #include <stdlib.h>

       size_t wcstombs(char *dest, const wchar_t *src, size_t n);

       Si dest n’est pas un pointeur NULL, la fonction wcstombs() convertit la
       chaîne  de  caractères larges src vers la séquence multioctet située en
       dest. Au plus n octets seront écrits dans dest.  La  conversion  débute
       dans  l’état  initial.  La  conversion  peut  se  terminer  pour  trois
       raisons :

       1. Un caractère large que l’on ne peut pas représenter par une séquence
       multioctet  (dans  la locale utilisée) a été rencontré. Dans ce cas, la
       fonction renverra (size_t) -1.

       2. La limite de longueur force l’arrêt. Dans ce cas, le nombre d’octets
       écrits dans dest est renvoyé, mais l’état de décalage est perdu.

       3.  La  chaîne  de  caractères  larges  a été complètement convertie, y
       compris le L'\0' final. Dans ce cas,  la  conversion  se  termine  dans
       l’état  initial.  La  fonction  renvoie  le nombre d’octets écrits dans
       dest, sans compter l’octet '\0' final.

       Le programmeur doit s’assurer qu’il y a assez de place pour au moins  n
       octets au minimum dans dest.

       Si  dest  est  NULL,  la  longueur  n  est ignorée, et la conversion se
       déroule comme précédemment, sauf que les octets convertis ne  sont  pas
       écrits  en  mémoire,  et  qu’il  n’y  a  pas  de  limite de longueur en
       destination.

       Pour éviter le cas 2 ci-dessus, le programmeur doit s’assurer que n est
       supérieur ou égal à wcstombs(NULL,src,0)+1.

VALEUR RENVOYÉE

       La fonction wcstombs() renvoie le nombre d’octets constituant la partie
       convertie de la séquence multioctet, sans compter l’octet nul final. Si
       elle  rencontre  un  caractère  large  qu’elle  ne peut convertir, elle
       renvoie (size_t) -1.

CONFORMITÉ

       C99.

NOTES

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

       La  fonction  wcsrtombs(3)  fournit  une  interface  sûre  en  contexte
       multithread pour la même fonctionnalité.

VOIR AUSSI

       wcsrtombs(3)

COLOPHON

       Cette page fait partie de  la  publication  3.23  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

       Cette  page  de  manuel  a  été  traduite et mise à jour par Christophe
       Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis  par
       Alain  Portal  <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement         gérées         par         Nicolas         François
       <nicolas.francois@centraliens.net>   et   l’équipe    francophone    de
       traduction de Debian.

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