MBSTOWCS(3) |
FreeBSD Library Functions Manual |
MBSTOWCS(3) |
名称
mbstowcs —
文字列をワイド文字列に変換する
ライブラリ
Standard C Library (libc, -lc)
書式
#include < stdlib.h>
size_t
mbstowcs( wchar_t * restrict wcstring, const char * restrict mbstring, size_t nwchars);
解説
mbstowcs() 関数は、初期変換状態で始まるワイド文字列
mbstring をワイド文字列
wcstring に変換します。わずか、
nwchars のワイド文字が格納されます。余地があれば、終端のヌルワイド文字が追加されます。
戻り値
mbstowcs() 関数は、変換されたワイド文字の数を返しますが、終端のヌルワイド文字は、含みません。または無効のマルチバイト文字に遭遇すると、-1 を返します。
エラー
mbstowcs() 関数は、次の場合に失敗します:
-
[
EILSEQ]
-
無効のマルチバイトシーケンスが検出されました。
-
[
EINVAL]
-
変換状態が無効です。
規格
mbstowcs() 関数は、 ISO/IEC 9899:1999 (“ISO C99”) に適合しています。