mbsnrtowcs(3) Library Functions Manual mbsnrtowcs(3) NOM mbsnrtowcs - Convertir une sequence multioctet en chaine de caracteres larges BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include size_t mbsnrtowcs(wchar_t dest[restrict .size], const char **restrict src, size_t nms, size_t size, mbstate_t *restrict ps); Exigences de macros de test de fonctionnalites pour la glibc (consulter feature_test_macros(7)) : mbsnrtowcs() : Depuis la glibc 2.10 : _POSIX_C_SOURCE >= 200809L Avant la glibc 2.10 : _GNU_SOURCE DESCRIPTION La fonction mbsnrtowcs() est equivalente a la fonction mbsrtowcs(3), sauf qu'elle ne convertit qu'un nombre limite a au plus nms octets commencant en *src. If dest is not NULL, the mbsnrtowcs() function converts at most nms bytes from the multibyte string *src to a wide-character string starting at dest. At most size wide characters are written to dest. The shift state *ps is updated. The conversion is effectively performed by repeatedly calling mbrtowc(dest, *src, n, ps) where n is some positive number, as long as this call succeeds, and then incrementing dest by one and *src by the number of bytes consumed. The conversion can stop for three reasons: - Une sequence multioctet incorrecte a ete rencontree. Dans ce cas, *src pointera sur la sequence incorrecte, et la fonction renvoie (size_t) -1 en positionnant errno a la valeur EILSEQ. - The nms limit forces a stop, or size non-L'\0' wide characters have been stored at dest. In this case, *src is left pointing to the next multibyte sequence to be converted, and the number of wide characters written to dest is returned. - The multibyte string has been completely converted, including the terminating null wide character ('\0') (which has the side effect of bringing back *ps to the initial state). In this case, *src is set to NULL, and the number of wide characters written to dest, excluding the terminating null wide character, is returned. Selon POSIX.1, si le tampon d'entree se termine par un caractere incomplet, il n'est pas specifie si la conversion s'arrete a la fin du caractere precedant (s'il existe) ou a la fin du tampon d'entree. L'implementation de la glibc suit le premier comportement. If dest is NULL, size is ignored, and the conversion proceeds as above, except that the converted wide characters are not written out to memory, and that no destination size limit exists. Dans tous les cas, si ps est un pointeur NULL, un etat anonyme statique, reserve a la fonction mbsnrtowcs() est utilise a sa place. The programmer must ensure that there is room for at least size wide characters at dest. VALEUR RENVOYEE La fonction mbsnrtowcs() renvoie le nombre de caracteres larges places dans la zone convertie, sans compter le caractere nul final. Si une sequence multioctet incorrecte est rencontree, la fonction renvoie (size_t) -1, et errno contient EILSEQ. ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +-------------+--------------------------+-----------------------------+ |Interface | Attribut | Valeur | +-------------+--------------------------+-----------------------------+ |mbsnrtowcs() | Securite des threads | MT-Unsafe | | | | race:mbsnrtowcs/!ps | +-------------+--------------------------+-----------------------------+ STANDARDS POSIX.1-2008. NOTES Le comportement de mbsnrtowcs() depend de la categorie LC_CTYPE de la localisation en cours. Passer NULL dans ps n'est pas sur dans un contexte multithread. VOIR AUSSI iconv(3), mbrtowc(3), mbsinit(3), mbsrtowcs(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 mbsnrtowcs(3)