mbrlen(3)                  Library Functions Manual                  mbrlen(3)

NOM
       mbrlen - Calculer la longueur d'un caractere multioctets

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <wchar.h>

       size_t mbrlen(const char s[restrict .n], size_t n,
                     mbstate_t *restrict ps);

DESCRIPTION
       La fonction mbrlen() examine au maximum n octets de la sequence
       commencant en s et en extrait le caractere multioctet complet suivant.
       Elle met a jour l'etat de decalage *ps. Si le caractere multioctet ne
       correspond pas au caractere large nul, elle renvoie le nombre d'octets
       qui ont ete lus dans s. Si ce caractere correspond au caractere large
       nul, elle reinitialise l'etat *ps et renvoie 0.

       Si les n octets commencant en s ne contiennent pas un caractere
       multioctet complet, mbrlen() renvoie (size_t) -2. Ceci peut se produire
       meme si n >= MB_CUR_MAX, dans le cas ou la sequence multioctet contient
       des sequences de decalage redondantes.

       Si la sequence multioctet commencant en s contient une sequence
       invalide avant le prochain caractere complet, mbrlen() renvoie
       (size_t) -1 et place dans errno la valeur EILSEQ. Dans ce cas, les
       effets sur *ps sont indefinis.

       Si ps est un pointeur NULL, une zone de memoire statique reservee a
       mbrlen() est utilisee a sa place.

VALEUR RENVOYEE
       La fonction mbrlen() renvoie le nombre d'octets balayes depuis la
       sequence commencant en s, si un caractere large non nul a ete reconnu.
       Elle renvoie zero si un caractere large nul est rencontre. Elle renvoie
       (size_t) -1 et remplit errno avec EILSEQ, si une sequence invalide est
       trouvee. Elle renvoie (size_t) -2 si elle n'a pas trouve de caractere
       entier, et si n doit etre augmente.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +---------------+--------------------------+---------------------------+
       |Interface      | Attribut                 | Valeur                    |
       +---------------+--------------------------+---------------------------+
       |mbrlen()       | Securite des threads     | MT-Unsafe race:mbrlen/!ps |
       +---------------+--------------------------+---------------------------+
STANDARDS
       C11, POSIX.1-2008.

HISTORIQUE
       POSIX.1-2001, C99.

NOTES
       Le comportement de mbrlen() depend de la categorie LC_CTYPE de la
       localisation en cours.

VOIR AUSSI
       mbrtowc(3)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org>, Jean-Baptiste Holcroft <jean-baptiste@holcroft.fr>
       et Gregoire Scano <gregoire.scano@malloc.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> 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 <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                      mbrlen(3)