Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] mbrlen - Calculer la longueur d'un caractère multi-octets. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <wchar.h>[/b] [b][i]size_t mbrlen (const char * s , size_t n , mbstate_t * ps );[/i][/b] .fi [size=18] [b]Description[/b] [/size] La fonction [b]mbrlen[/b] examine au maximum [i]n[/i] octets de la séquence commençant en [i]s[/i] et en extrait le caractère multi-octets complet suivant. Elle met à jour l'état de décalage [i]ps[/i]. Si le caractère multi-octets ne correspond pas au caractère large nul, elle renvoie le nombre d'octets qui ont été lus dans [i]s[/i]. Si ce caractère correspond au caractère large nul, elle réinitialise l'état [i]ps[/i] et renvoie 0. Si les [i]n[/i] octets commençant en [i]s[/i] ne contiennent pas un caractère multi-octets complet, [b]mbrlen[/b] renvoie [i](size_t)(-2)[/i]. Ceci peut se produire même si [i]n[/i] >= [i]MB_CUR_MAX[/i], dans le cas où la séquence multi-octets contient des séquences de décalage redondantes. Si la séquence multi-octets commençant en [i]s[/i] contient une séquence invalide avant le prochain caractère complet, [b]mbrlen[/b] renvoie [i](size_t)(-1)[/i] et place dans [b]errno[/b] la valeur [b]EILSEQ[/b]. Dans ce cas, les effets sur [i]*ps[/i] sont indéfinis. Si [i]ps[/i] est un pointeur NULL, une zone de mémoire statique réservée à mbrlen est utilisée à sa place. [size=18] [b]Valeur renvoyée[/b] [/size] La fonction [b]mbrlen[/b] renvoie le nombre d'octets balayés depuis la séquence commençant en [i]s[/i], 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 [b]errno[/b] avec [b]EILSEQ[/b], 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 [i]n[/i] doit être augmenté. [size=18] [b]Conformité[/b] [/size] ISO/ANSI C, UNIX98 [size=18] [b]Voir aussi[/b] [/size] [b]mbrtowc (3)[/b] [size=18] [b]Notes[/b] [/size] Le comportement de [b]mbrlen[/b] dépend de la catégorie LC_CTYPE de la localisation. [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 2000-2003.
Fichier