Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       mbsinit - Verifier si la conversion est dans l'etat initial

SYNOPSIS

       #include <wchar.h>

       int mbsinit(const mbstate_t *ps);

DESCRIPTION

       La conversion de caracteres entre la representation multi-octets et les
       caracteres larges emploie un etat  de  type  mbstate_t.  La  conversion
       d'une  chaine  utilise  un  automate  a  etats  finis.  Lorsqu'elle est
       interrompue apres la conversion d'un nombre entier  de  caracteres,  il
       peut  etre  necessaire  de  memoriser  son  etat  pour  pouvoir traiter
       ulterieurement le reste de la chaine. Un tel  etat  de  conversion  est
       indispensable pour certains encodages tels que ISO-2022 et UTF-7.

       L'etat initial est celui du debut de la conversion d'une chaine. Il y a
       deux types d'etats, celui utilise par les conversions  multi-octets  en
       caracteres  larges,  comme  pour mbsrtowcs(3), et celui employe par les
       conversions inverses, comme  pour  wcsrtombs(3).  Toutefois,  les  deux
       types  peuvent  etre  stockes  dans  une  variable mbstate_t, et ils se
       presentent tous deux l'etat initial sous la meme forme.

       Pour les codages 8 bits, tous  les  etats  sont  equivalents  a  l'etat
       initial.  Pour  les  encodages  multi-octets comme UTF-8, EUC-* BIG5 ou
       SJIS, les fonctions de conversion de caracteres larges en  multi-octets
       ne  produisent  jamais  d'etat  non  initial,  mais  les  fonctions  de
       conversion  multi-octets  en   caracteres   larges   comme   mbrtowc(3)
       produisent  un  etat  non  initial si elles sont interrompues au milieu
       d'un caractere.

       Une possibilite pour creer un etat mbstate_t initial est de le fixer  a
       zero :

           mbstate_t state;
           memset(&state,0,sizeof(mbstate_t));

       Sous  Linux,  on  peut  aussi  utiliser la ligne suivante, meme si elle
       declenche des avertissements du compilateur :

           mbstate_t state = { 0 };

       La fonction mbsinit() verifie si *ps correspond a un etat initial.

VALEUR RENVOY'EE

       La fonction mbsinit() renvoie une valeur non  nulle  si  *ps  est  dans
       l'etat  initial,  ou  si  ps  est un pointeur NULL. Sinon, elle renvoie
       zero.

CONFORMIT'E

       C99.

NOTES

       Le comportement de mbsinit() depend de  la  categorie  LC_CTYPE  de  la
       localisation en cours.

VOIR AUSSI

       mbsrtowcs(3), wcsrtombs(3)

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.27 du projet man-pages
       Linux. Une description du projet et des instructions pour signaler  des
       anomalies       peuvent       etre       trouvees      a      l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

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

       Christophe  Blaess  <URL:http://www.blaess.fr/christophe/> (1996-2003),
       Alain Portal <URL:http://manpagesfr.free.fr/>  (2003-2006).   Florentin
       Duneau et l'equipe francophone de traduction de Debian (2006-2009).

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

       Vous  pouvez  toujours avoir acces a la version anglaise de ce document
       en utilisant la commande << man -L C <section> <page_de_man> >>.