MBLEN

Section: Linux Programmer's Manual (3)
Updated: 1999-07-25
Index JM Home Page roff page

名前

mblen - 次のマルチバイト文字のバイト数を返す

書式

#include <stdlib.h>

int mblen(const char *s, size_t n);

説明

s が NULL ポインターでなければ、 mblen() 関数は s から始まる最大 n バイトのマルチバイト文字列を検査して、次の完全なマルチバイト文字を取り出す。これには mblen 関数のみが使用する静的で名前のないシフト状態が使用される。マルチバイト文字がナルワイド文字でなければ s から消費されるバイト数を返す。マルチバイト文字がナルワイド文字ならば 0 を返す。

s から始まる n バイトが完全なマルチバイト文字を含んでいなければ、 mblen() は -1 を返す。マルチバイト文字列に冗長なシフトシーケンスが含まれていると n >= MB_CUR_MAX の場合にもこのようなことが起こりえる。

s から始まるマルチバイト文字列が次の完全な文字の前に不正なマルチバイト列を含んでいる場合にも、 mblen() は -1 を返す。

s が NULL ポインターならば、 mblen() 関数はこの関数のみが使用するシフト状態を初期化状態に戻し、シフト状態を使用した文字符号の場合にはゼロ以外を、文字符号がシフト状態を持たない場合にはゼロを返す。

返り値

mblen() 関数は s から始まるマルチバイト列を検査してナルワイド文字以外を確認した場合にはそのバイト数を返す。ナルワイド文字を確認した場合にはゼロを返す。不正なマルチバイト列に遭遇した場合や完全なマルチバイト文字を解析できなかった場合には -1 を返す。

準拠

C99

注意

mblen() の動作は現在のロケールの LC_CTYPE カテゴリに依存している。

mbrlen(3) 関数は同じ機能のより良いインタフェースを提供する。

This document was created by man2html, using the manual pages.
Time: 04:31:51 GMT, November 19, 2007

MBLEN

名前

書式

説明

返り値

準拠

注意

関連項目

Index