.\" Translated Sat Oct 23 15:38:11 JST 1999
.\" by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
-.TH WCSRTOMBS 3 2011\-10\-16 GNU "Linux Programmer's Manual"
+.TH WCSRTOMBS 3 2014\-03\-18 GNU "Linux Programmer's Manual"
.SH 名前
wcsrtombs \- ワイド文字文字列をマルチバイト文字列に変換する
.SH 書式
\fB size_t \fP\fIlen\fP\fB, mbstate_t *\fP\fIps\fP\fB);\fP
.fi
.SH 説明
-\fIdest\fP ã\81\8c NULL ã\83\9dã\82¤ã\83³ã\82¿ã\81§ã\81ªã\81\91ã\82\8cã\81°ã\80\81 \fBwcsrtombs\fP() é\96¢æ\95°ã\81¯ ã\83¯ã\82¤ã\83\89æ\96\87å\97æ\96\87å\97å\88\97 \fI*src\fP ã\82\92 \fIdest\fP
+\fIdest\fP が NULL でなければ、 \fBwcsrtombs\fP() 関数は ワイド文字文字列 \fI*src\fP を \fIdest\fP
が指すマルチバイト文字列 に変換する。最大 \fIlen\fP バイトまでが \fIdest\fP に書き込まれる。 シフト状態 \fI*ps\fP
は更新される。実際の効果としては、この変換は以下 の動作と同じになる: \fIwcrtomb(dest, *src, ps)\fP を呼び、成功が返ったら、
\fIdest\fP を書き込んだバイト数だけ増やし、\fI*src\fP を 1 増やす。 そして、wcrtomb が成功を返す限りこれを繰り返す。
2. 長さの制限により変換が止められた場合。この場合には、\fI*src\fP は次に 変換されるべきワイド文字列を指した状態になり、\fIdest\fP
に書き込まれ たバイト数が返される。
.PP
-3. ワイド文字列が終端の NULL ワイド文字 (L\(aq\e0\(aq) も含めて全て 変換された場合。この際、\fI*ps\fP
+3. ワイド文字列が終端のヌルワイド文字 (L\(aq\e0\(aq) も含めて全て 変換された場合。この際、\fI*ps\fP
が初期状態に戻るという副作用がある。 この場合には \fI*src\fP に NULL が設定され、\fIdest\fP に書き込まれた バイト数が返される
-(終端の NULL バイト (L\(aq\e0\(aq) は数えない)。
+(終端のヌルバイト (L\(aq\e0\(aq) は数えない)。
.PP
\fIdest\fP が NULL ならば \fIlen\fP は無視されて前述のように変換が行わ
れるが、変換されたバイトデータはメモリに書き出されない点と、出力先の長 さの制限がない点が異なる。
.PP
-ä¸\8aè¨\98ã\81®ã\81\84ã\81\9aã\82\8cã\81®å ´å\90\88ã\82\82ã\80\81\fIps\fP ã\81\8c NULL ã\83\9dã\82¤ã\83³ã\82¿ã\81ªã\82\89ã\81°ã\80\81\fBwcsrtombs\fP() é\96¢æ\95°
+上記のいずれの場合も、\fIps\fP が NULL ならば、\fBwcsrtombs\fP() 関数
だけが知っている静的な匿名の状態がシフト状態の代わりに用いられる。
.PP
プログラマは少なくとも \fIlen\fP バイトの領域を \fIdest\fP に確保しな ければならない。
.PP
\fIps\fP に NULL を渡した際の動作はマルチスレッドセーフでない。
.SH 関連項目
-\fBiconv\fP(3), \fBwcsnrtombs\fP(3), \fBwcstombs\fP(3)
+\fBiconv\fP(3), \fBmbsinit\fP(3), \fBwcrtomb\fP(3), \fBwcsnrtombs\fP(3), \fBwcstombs\fP(3)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.68 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
