Man page - mbrlen(3)

Packages contains this manual

Available languages:

en fr es ja ru ro de

Manual

mbrlen

NOM
BIBLIOTHÈQUE
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ATTRIBUTS
STANDARDS
HISTORIQUE
NOTES
VOIR AUSSI
TRADUCTION

NOM

mbrlen - Calculer la longueur d’un caractùre multioctets

BIBLIOTHÈQUE

BibliothĂšque 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 sĂ©quence commençant en s et en extrait le caractĂšre multioctet complet suivant. Elle met Ă  jour l’état de dĂ©calage *ps . Si le caractĂšre multioctet ne correspond pas au caractĂšre large nul, elle renvoie le nombre d’octets qui ont Ă©tĂ© lus dans s . Si ce caractĂšre correspond au caractĂšre large nul, elle rĂ©initialise l’état *ps et renvoie 0.

Si les n octets commençant en s ne contiennent pas un caractĂšre multioctet complet, mbrlen () renvoie (size_t) -2 . Ceci peut se produire mĂȘme si n >= MB_CUR_MAX , dans le cas oĂč la sĂ©quence multioctet contient des sĂ©quences de dĂ©calage redondantes.

Si la séquence multioctet commençant en s contient une séquence invalide avant le prochain caractÚre complet, mbrlen () renvoie (size_t) -1 et place dans errno la valeur EILSEQ . Dans ce cas, les effets sur *ps sont indéfinis.

Si ps est un pointeur NULL, une zone de mémoire statique réservée à mbrlen () est utilisée à sa place.

VALEUR RENVOYÉE

La fonction mbrlen () renvoie le nombre d’octets balayĂ©s depuis la sĂ©quence commençant en s , si un caractĂšre large non nul a Ă©tĂ© reconnu. Elle renvoie zĂ©ro si un caractĂšre large nul est rencontrĂ©. Elle renvoie (size_t) -1 et remplit errno avec EILSEQ , si une sĂ©quence invalide est trouvĂ©e. Elle renvoie (size_t) -2 si elle n’a pas trouvĂ© de caractĂšre entier, et si n doit ĂȘtre augmentĂ©.

ATTRIBUTS

Pour une explication des termes utilisés dans cette section, consulter attributes (7).

Image grohtml-3877610-1.png

STANDARDS

C11, POSIX.1-2008.

HISTORIQUE

POSIX.1-2001, C99.

NOTES

Le comportement de mbrlen () dépend de la catégorie LC_CTYPE de la localisation en cours.

VOIR AUSSI

mbrtowc (3)

TRADUCTION

La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org>, Jean-Baptiste Holcroft <jean-baptiste@holcroft.fr> et Grégoire Scano <gregoire.scano@malloc.fr>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n’y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org .