EN JA
MBSTOWCS(3)
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”) に適合しています。
April 8, 2004 FreeBSD