Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
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> >>.