mbtowc(3) Library Functions Manual mbtowc(3) NOM mbtowc - Convertir une sequences multioctet en caracteres larges BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include int mbtowc(wchar_t *restrict pwc, const char s[restrict .n], size_t n); DESCRIPTION L'utilisation habituelle de cette fonction est avec s et pwc tous deux differents NULL. Dans ce cas, la fonction mbtowc() examine au plus n octets de la chaine multioctet commencant a l'adresse s, extrait le prochain caractere multioctet complet, le convertit en caractere large et le stocke dans *pwc. Elle met a jour l'etat interne de decalage, connu d'elle seule. Si s ne pointe pas sur un octet nul (<< \0 >>), elle renvoie le nombre d'octets qui ont ete consommes dans s, sinon, elle renvoie zero. Si les n octets debutants en s ne contiennent pas un caractere multioctet complet, ou s'il s'agit d'une sequence incorrecte, mbtowc() renvoie -1. Ceci peut se produire meme si n est superieur ou egal a MB_CUR_MAX, si la chaine multioctet contient des sequences de decalage redondantes. Un autre cas possible se present si s est non NULL, mais pwc est NULL. Dans ce cas, la fonction mbtowc() se comporte comme ci-dessus, mais ne stocke par le caractere large en memoire. Un troisieme cas est possible si s est NULL. Alors, pwc et n sont ignores. La fonction mbtowc() reinitialise l'etat de decalage, qu'elle seule connait, et renvoie une valeur non nulle si l'encodage a un etat de decalage non trivial, ou zero si l'encodage est sans etat. VALEUR RENVOYEE Si s est non NULL, la fonction mbtowc() renvoie le nombre d'octets consommes a partir de s, ou zero si s pointe sur un octet nul, ou encore -1 en cas d'erreur. Si s est NULL, la fonction mbtowc() renvoie une valeur non nulle si l'encodage a un etat de decalage non trivial, ou zero si l'encodage est sans etat. ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +--------------------------+--------------------------+----------------+ |Interface | Attribut | Valeur | +--------------------------+--------------------------+----------------+ |mbtowc() | Securite des threads | MT-Unsafe race | +--------------------------+--------------------------+----------------+ VERSIONS Cette fonction n'est pas sure en contexte multithread. La fonction mbrtowc(3) fournit une meilleure interface pour la meme fonctionnalite. STANDARDS C11, POSIX.1-2008. HISTORIQUE POSIX.1-2001, C99. NOTES Le comportement de mbtowc() depend de la categorie LC_CTYPE de la localisation en cours. VOIR AUSSI MB_CUR_MAX(3), mblen(3), mbrtowc(3), mbstowcs(3), wcstombs(3), wctomb(3) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier et David Prevot Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 mbtowc(3)