.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
-.TH WCSNRTOMBS 3 2011\-10\-16 GNU "Linux Programmer's Manual"
+.\"
+.\" Translated Fri Oct 22 01:12:12 JST 1999
+.\" by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
+.\"
+.TH WCSNRTOMBS 3 2014\-03\-18 GNU "Linux Programmer's Manual"
.SH 名前
wcsnrtombs \- ワイド文字文字列をマルチバイト文字列に変換する
.SH 書式
\fBwcsnrtombs\fP() 関数は、 \fBwcsrtombs\fP() 関数に似ている。ただし、 変換されるワイド文字の数が(\fI*src\fP
から数えて) \fInwc\fP 文字に制限 されている点が異なる。
.PP
-\fIdest\fP ã\81\8c NULL ã\83\9dã\82¤ã\83³ã\82¿ã\81§ã\81ªã\81\91ã\82\8cã\81°ã\80\81 \fBwcsnrtombs\fP() é\96¢æ\95°ã\81¯ ã\83¯ã\82¤ã\83\89æ\96\87å\97æ\96\87å\97å\88\97ã\81®æ\9c\80大 \fInwc\fP å\80\8bã\81¾ã\81§ã\81®ã\83¯ã\82¤ã\83\89æ\96\87å\97ã\82\92
+\fIdest\fP が NULL でなければ、 \fBwcsnrtombs\fP() 関数は ワイド文字文字列の最大 \fInwc\fP 個までのワイド文字を
\fIdest\fP から 始まるマルチバイト文字列に変換する。\fIdest\fP には最大 \fIlen\fP バイ トまで書き込まれる。シフト状態 \fI*ps\fP
は更新される。実際の効果とし ては、この変換は以下の動作と同じになる: \fIwcrtomb(dest, *src, ps)\fP を呼び、成功が返ったら
\fIdest\fP を書き込んだバイト数だけ増やし、\fI*src\fP を 1 増やす。 そして、wcrtomb が成功を返す限りこれを繰り返す。
変換が止まる理由は 3 つ考えられる:
-.PP
-1. (現在のロケールに基づいて)マルチバイト列で表現できないワイド文字に 出会った場合。この場合は、\fI*src\fP
-は不正なワイド文字を指した状態になり、 \fI(size_t)\ \-1\fP が返され、\fIerrno\fP に \fBEILSEQ\fP が設定される。
-.PP
-2. NULL ワイド文字 (L\(aq\e0\(aq) に出会わないで \fInwc\fP 個のワイド文字を
+.IP 1. 3
+(現在のロケールに基づいて)マルチバイト列で表現できないワイド文字に 出会った場合。この場合は、\fI*src\fP は不正なワイド文字を指した状態になり、
+\fI(size_t)\ \-1\fP が返され、\fIerrno\fP に \fBEILSEQ\fP が設定される。
+.IP 2.
+NULL ワイド文字 (L\(aq\e0\(aq) に出会わないで \fInwc\fP 個のワイド文字を
変換した場合か、長さの制限によって変換が止められた場合。 この場合には、\fI*src\fP は次に変換されるべきワイド文字を指した状態になり、
\fIdest\fP に書き込まれたバイト数が返される。
-.PP
-3. ワイド文字列が終端の L\(aq\e0\(aq (これには \fI*ps\fP を初期状態に戻すという副作用がある)
+.IP 3.
+ワイド文字列が終端の L\(aq\e0\(aq (これには \fI*ps\fP を初期状態に戻すという副作用がある)
も含めて全て変換された場合。この場合には \fI*src\fP に NULL が設定され、
\fIdest\fP に書き込まれたバイト数が返される
(終端の NULL バイト (\(aq\e0\(aq) は数えない)。
\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\fBwcsnrtombs\fP() é\96¢æ\95°
+上記のいずれの場合も、\fIps\fP が NULL ならば、\fBwcsnrtombs\fP() 関数
だけが知っている静的な匿名の状態がシフト状態の代わりに用いられる。
.PP
プログラマは少なくとも \fIlen\fP バイトの領域を \fIdest\fP に確保しな ければならない。
.PP
\fIps\fP に NULL を渡した際の動作はマルチスレッドセーフでない。
.SH 関連項目
-\fBiconv\fP(3), \fBwcsrtombs\fP(3)
+\fBiconv\fP(3), \fBmbsinit\fP(3), \fBwcsrtombs\fP(3)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.51 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.64 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
