wcsrtombs(3) Library Functions Manual wcsrtombs(3) NOM wcsrtombs - Convertir une chaine de caracteres larges en sequence multioctet BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include size_t wcsrtombs(char dest[restrict .len], const wchar_t **restrict src, size_t len, mbstate_t *restrict ps); DESCRIPTION Si dest n'est pas NULL, la fonction wcsrtombs() convertit les caracteres larges depuis la chaine *src vers la sequence multioctet situee en dest. Au plus len octets seront ecrits dans dest. L'etat de conversion *ps est mis a jour. La conversion est realisee en invoquant wcrtomb(dest, *src, ps) aussi longtemps que cet appel reussit, en augmentant a chaque fois dest du nombre d'octets ecrits et en incrementant *src. La conversion peut s'arreter pour trois raisons : - Un caractere large que l'on ne peut pas representer par une sequence multioctet (dans la locale utilisee) a ete rencontre. Dans ce cas *src pointera sur le caractere non valable et la fonction renverra (size_t) -1 et place EILSEQ dans errno. - La limite len est atteinte. Dans ce cas *src pointera sur le caractere suivant a convertir et la fonction renvoie le nombre d'octets ecrits dans dest. - La chaine de caracteres larges a ete completement convertie, y compris le caractere large nul final (L'\0'), ramenant *ps a l'etat initial. Dans ce cas, *src devient NULL et la fonction renvoie le nombre d'octets ecrits dans dest, sans compter l'octet nul final ('\0'). Si dest est NULL, la longueur len est ignoree et la conversion se deroule comme precedemment, sauf que les octets convertis ne sont pas ecrits en memoire et qu'il n'y a pas de limite de longueur en destination. Dans tous les cas, si ps est NULL, un etat anonyme statique, reserve a la fonction wcsrtombs(), est utilise a sa place. Le programmeur doit s'assurer qu'il y a assez de place pour au moins len octets dans dest. VALEUR RENVOYEE La fonction wcsrtombs() renvoie le nombre d'octets constituant la partie convertie de la sequence multioctet, sans compter l'octet nul final. Si elle rencontre un caractere large qu'elle ne peut convertir, elle renvoie (size_t) -1 et place EILSEQ dans errno. ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +------------+--------------------------+------------------------------+ |Interface | Attribut | Valeur | +------------+--------------------------+------------------------------+ |wcsrtombs() | Securite des threads | MT-Unsafe race:wcsrtombs/!ps | +------------+--------------------------+------------------------------+ STANDARDS C11, POSIX.1-2008. HISTORIQUE POSIX.1-2001, C99. NOTES Le comportement de wcsrtombs() depend de la categorie LC_CTYPE de la locale utilisee. Passer NULL dans ps n'est pas sur dans un contexte multithread. VOIR AUSSI iconv(3), mbsinit(3), wcrtomb(3), wcsnrtombs(3), wcstombs(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 , David Prevot , Jean-Baptiste Holcroft et Gregoire Scano 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 wcsrtombs(3)