Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
NOM
wcsnrtombs - Convertir une chaine de caracteres larges en sequence
multioctet
SYNOPSIS
#include <wchar.h>
size_t wcsnrtombs(char *dest, const wchar_t **src, size_t nwc,
size_t len, mbstate_t *ps);
Exigences de macros de test de fonctionnalites pour la glibc (consultez
feature_test_macros(7)) :
wcsnrtombs() :
Depuis la glibc 2.10 :
_XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
Avant la glibc 2.10 :
_GNU_SOURCE
DESCRIPTION
La fonction wcsnrtombs() est l'equivalent de wcsrtombs(3), sauf que le
nombre de caracteres larges a convertir est limite (a nwc), en
commencant en *src.
Si dest n'est pas un pointeur NULL, la fonction wcsnrtombs() convertit
au maximum nwc 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
fait en invoquant a repetition 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 de 1. La conversion peut se
terminer pour trois raisons :
1. 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 invalide, et la fonction renverra (size_t) -1
apres avoir place EILSEQ dans errno.
2. On a converti nwc caracteres larges sans rencontrer L'\0', ou 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.
3. La chaine de caracteres larges a ete completement convertie, y
compris le L'\0' final (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 '\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 un pointeur NULL, un etat statique anonyme
propre a la fonction est utilise a la place.
Le programmeur doit s'assurer qu'il y a assez de place pour au moins
len octets au minimum dans dest.
VALEUR RENVOY'EE
La fonction wcsnrtombs 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.
CONFORMIT'E
Cette fonction est une extension GNU.
NOTES
Le comportement de wcsnrtombs() depend de la categorie LC_CTYPE de la
locale utilisee.
L'utilisation d'un pointeur NULL pour ps n'est pas sure dans un
contexte multithread.
VOIR AUSSI
iconv(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). Nicolas
Francois 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> >>.