OpenVMS マニュアル

mbtowc

マルチバイト文字を，それと等価なワイド文字に変換します。

形式

#include <stdlib.h>

int mbtowc (wchar_t *pwc, const char *s, size_t n);

引数

pwc

結果として得られるワイド文字コードへのポインタ。

s

マルチバイト文字へのポインタ。

n

次のマルチバイト文字を構成するバイトの数の最大値。

説明

文字が n バイト以下である場合， mbtowc関数は s がポイントするマルチバイト文字を，それと等価なワイド文字に変換します。文字が無効であるか，n バイトよりも大きい場合，関数はエラーを示す - 1 を返します。

pwc が NULL ポインタで，s が null ポインタでない場合，関数は (n の値にかかわらず) s がポイントするマルチバイト文字を構成するバイト数を判定します。

この関数は，プログラムのカレント・ロケールの LC_CTYPE カテゴリの影響を受けます。

戻り値

x	s がポイントする有効な文字を構成するバイト数。
0	s は NULL ポインタであるか，null バイトへのポインタです。
-1	エラーを示します。関数は errno を，無効な文字が検出されたことを示す EILSEQ に設定します。