|
| wcstombs |
| ||||
| wcstombs | |
| ヘッダ | #include <stdlib.h> |
| 形 式 | size_t wcstombs(char * restrict s, const wchar_t * restrict pwcs, size_t n); |
| 機 能 | pwcsが指す配列中のワイド文字の列を、初期シフト状態から始まる対応する多バイト文字の並びに変換し、sが指す配列に格納する。ただし、多バイト文字が合計でnバイトの上限を超えるとき、または、ナル文字が格納されたとき、配列への格納を終了する。各ワイド文字は、wctomb関数の変換状態が影響を受けないことを除いて、wctomb関数の呼出しによる場合と同じ規則で変換する。 sが指す配列内でnバイト以下の要素しか変更しない。領域の重なり合うオブジェクト間でコピーが行われるときの動作は定義されない。 |
| 返却値 | 正しい多バイト文字に対応しないワイド文字が含まれているときは、(size_t)(-1)を返す。それ以外の場合は、変更されたバイト数を返す。ただし、終端ナル文字は、（もしあっても）含めない。 |
