名称

wcstombs — ワイド文字列を文字列に変換する

ライブラリ

Standard C Library (libc, -lc)

書式

#include < stdlib.h>

size_t
wcstombs( char * restrict mbstring, const wchar_t * restrict wcstring, size_t nbytes);

解説

wcstombs() 関数は、ワイド文字列 wcstring を初期変換状態で始まるマルチバイト文字列 mbstring に変換します。 nbytes バイトまで mbstring に格納されます。文字列の最後で部分的なマルチバイト文字は格納されません。余地がある場合、マルチバイト文字列はヌル文字で終わります。

戻り値

wcstombs() 関数は、成功すれば (どんな終端のヌル文字も含まずに) 変換されたワイド文字の数を返し、そうでなければ ( size_t)-1 を返します。

エラー

wcstombs() 関数は、次の場合に失敗します:

[ EILSEQ]

無効のワイド文字に遭遇しました。

[ EINVAL]

変換状態は無効です。

関連項目

mbstowcs(3), multibyte(3), wcsrtombs(3), wctomb(3)

規格

wcstombs() 関数は、 ISO/IEC 9899:1999 (“ISO C99”) に適合しています。