mblen
C言語 標準ライブラリ
アルファベット順索引
ヘッダ別索引
ホームページへ
C言語講座のページ
C
89
C
99
C
11
多バイト文字・ワイド文字変換関数
mblen
ヘッダ
#include <
stdlib.h
>
形 式
int mblen(const char *s,
size_t
n);
機 能
本関数は、sが空ポインタでない場合に、そのsが指す多バイト文字を構成するバイト数を決定する。
mbtowc
関数の変換状態が影響を受けないことを除くと、
mbtowc
((
wchar_t
*)0, s, n)
と等価である。
いかなるライブラリ関数も、本関数を呼び出さないかのように動作する。
返却値
sが空ポインタである場合
多バイト文字の表現形式がシフト状態に依存していれば0以外の値を返し、そうでなければ0を返す。
sが空ポインタでない場合
sがナル文字を指す場合
0を返す。
sがナル文字を指さない場合
続くn個以下のバイト列が正しい多バイト文字を形成するとき、その多バイト文字を構成するバイト数を返す。
そうでない場合は-1を返す。