WCSRTOMBS

名前

書式

#include <wchar.h>

size_t wcsrtombs(char *dest, const wchar_t **src,
                 size_t len, mbstate_t *ps);

説明

1.

(現在のロケールに基づいて)マルチバイト列で表現できないワイド文字に 出会った場合。この場合は、*src は不正なワイド文字を指した状態になり、 (size_t) -1 が返され、errno に EILSEQ が設定される。

2.

長さの制限により変換が止められた場合。この場合には、*src は次に 変換されるべきワイド文字列を指した状態になり、dest に書き込まれ たバイト数が返される。

3.

ワイド文字列が終端のヌルワイド文字 (L'\0') も含めて全て 変換された場合。この際、*ps が初期状態に戻るという副作用がある。 この場合には *src に NULL が設定され、dest に書き込まれた バイト数が返される (終端のヌルバイト (L'\0') は数えない)。

dest が NULL ならば len は無視されて前述のように変換が行わ れるが、変換されたバイトデータはメモリーに書き出されない点と、出力先の長 さの制限がない点が異なる。

上記のいずれの場合も、ps が NULL ならば、wcsrtombs() 関数 だけが知っている静的な匿名の状態がシフト状態の代わりに用いられる。

プログラマは少なくとも len バイトの領域を dest に確保しな ければならない。  

返り値

属性

準拠

注意

ps に NULL を渡した際の動作はマルチスレッドセーフでない。  

関連項目

この文書について

関連キーワード

Linux マニュアル 一覧

関連するコマンド・関数

Index

名前

書式

説明

返り値

属性

準拠

注意

関連項目

この文書について