WCSTOMBS(3) |
FreeBSD Library Functions Manual |
WCSTOMBS(3) |
名称
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]
-
変換状態は無効です。
規格
wcstombs() 関数は、 ISO/IEC 9899:1999 (“ISO C99”) に適合しています。