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 .size], const wchar_t **restrict src, size_t size, mbstate_t *restrict ps); DESCRIPTION If dest is not NULL, the wcsrtombs() function converts the wide-character string *src to a multibyte string starting at dest. At most size bytes are written to dest. The shift state *ps is updated. The conversion is effectively performed by repeatedly calling wcrtomb(dest, *src, ps), as long as this call succeeds, and then incrementing dest by the number of bytes written and *src by one. The conversion can stop for three reasons: - 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. - The size limit forces a stop. In this case, *src is left pointing to the next wide character to be converted, and the number of bytes written to dest is returned. - 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'). If dest is NULL, size is ignored, and the conversion proceeds as above, except that the converted bytes are not written out to memory, and that no size limit exists. Dans tous les cas, si ps est NULL, un etat anonyme statique, reserve a la fonction wcsrtombs(), est utilise a sa place. The programmer must ensure that there is room for at least size bytes at 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.12 17 novembre 2024 wcsrtombs(3)