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