.\" Dinkumware C library reference http://www.dinkumware.com/
.\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\"
-.\" About this Japanese page, please contact to JM Project <JM@linux.or.jp>
-.\" Translated Fri Oct 22 01:12:12 JST 1999
-.\" by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
+.\"*******************************************************************
.\"
-.TH WCSNRTOMBS 3 2011-10-01 "GNU" "Linux Programmer's Manual"
-.\"O .SH NAME
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH WCSNRTOMBS 3 2011\-10\-16 GNU "Linux Programmer's Manual"
.SH 名前
-.\"O wcsnrtombs \- convert a wide-character string to a multibyte string
wcsnrtombs \- ワイド文字文字列をマルチバイト文字列に変換する
-.\"O .SH SYNOPSIS
.SH 書式
.nf
-.B #include <wchar.h>
+\fB#include <wchar.h>\fP
.sp
-.BI "size_t wcsnrtombs(char *" dest ", const wchar_t **" src ", size_t " nwc ,
-.BI " size_t " len ", mbstate_t *" ps );
+\fBsize_t wcsnrtombs(char *\fP\fIdest\fP\fB, const wchar_t **\fP\fIsrc\fP\fB, size_t \fP\fInwc\fP\fB,\fP
+\fB size_t \fP\fIlen\fP\fB, mbstate_t *\fP\fIps\fP\fB);\fP
.fi
.sp
.in -4n
-.\"O Feature Test Macro Requirements for glibc (see
-.\"O .BR feature_test_macros (7)):
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
-.BR wcsnrtombs ():
+\fBwcsnrtombs\fP():
.PD 0
.ad l
.RS 4
-.TP 4
-.\"O Since glibc 2.10:
+.TP 4
glibc 2.10 以降:
_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
-.TP
-.\"O Before glibc 2.10:
+.TP
glibc 2.10 より前:
_GNU_SOURCE
.RE
.ad
.PD
-.\"O .SH DESCRIPTION
.SH 説明
-.\"O The
-.\"O .BR wcsnrtombs ()
-.\"O function is like the
-.\"O .BR wcsrtombs (3)
-.\"O function,
-.\"O except that the number of wide characters to be converted,
-.\"O starting at \fI*src\fP, is limited to \fInwc\fP.
-.BR wcsnrtombs ()
-関数は、
-.BR wcsrtombs ()
-関数に似ている。ただし、
-変換されるワイド文字の数が(\fI*src\fP から数えて) \fInwc\fP 文字に制限
-されている点が異なる。
+\fBwcsnrtombs\fP() 関数は、 \fBwcsrtombs\fP() 関数に似ている。ただし、 変換されるワイド文字の数が(\fI*src\fP
+から数えて) \fInwc\fP 文字に制限 されている点が異なる。
.PP
-.\"O If \fIdest\fP is not a NULL pointer,
-.\"O the
-.\"O .BR wcsnrtombs ()
-.\"O function converts
-.\"O at most \fInwc\fP wide characters from
-.\"O the wide-character string \fI*src\fP to a multibyte string starting at
-.\"O \fIdest\fP.
-.\"O At most \fIlen\fP bytes are written to \fIdest\fP.
-.\"O The shift state
-.\"O \fI*ps\fP is updated.
-.\"O The conversion is effectively performed by repeatedly
-.\"O calling
-.\"O .IR "wcrtomb(dest, *src, ps)" ,
-.\"O as long as this call succeeds,
-.\"O and then incrementing \fIdest\fP by the
-.\"O number of bytes written and \fI*src\fP
-.\"O by one.
-.\"O The conversion can stop for three reasons:
-\fIdest\fP が NULL ポインタでなければ、
-.BR wcsnrtombs ()
-関数は
-ワイド文字文字列の最大 \fInwc\fP 個までのワイド文字を \fIdest\fP から
-始まるマルチバイト文字列に変換する。\fIdest\fP には最大 \fIlen\fP バイ
-トまで書き込まれる。シフト状態 \fI*ps\fP は更新される。実際の効果とし
-ては、この変換は以下の動作と同じになる:
-.IR "wcrtomb(dest, *src, ps)"
-を呼び、成功が返ったら
-\fIdest\fP を書き込んだバイト数だけ増やし、\fI*src\fP を 1 増やす。
-そして、wcrtomb が成功を返す限りこれを繰り返す。
+\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
-.\"O 1. A wide character has been encountered that can not be represented as a
-.\"O multibyte sequence (according to the current locale).
-.\"O In this case \fI*src\fP
-.\"O is left pointing to the invalid wide character,
-.\"O .I (size_t)\ \-1
-.\"O is returned,
-.\"O and \fIerrno\fP is set to \fBEILSEQ\fP.
-1. (現在のロケールに基づいて)マルチバイト列で表現できないワイド文字に
-出会った場合。この場合は、\fI*src\fP は不正なワイド文字を指した状態になり、
-.I (size_t)\ \-1
-が返され、\fIerrno\fP に \fBEILSEQ\fP が設定される。
+1. (現在のロケールに基づいて)マルチバイト列で表現できないワイド文字に 出会った場合。この場合は、\fI*src\fP
+は不正なワイド文字を指した状態になり、 \fI(size_t)\ \-1\fP が返され、\fIerrno\fP に \fBEILSEQ\fP が設定される。
.PP
-.\"O 2. \fInwc\fP wide characters have been
-.\"O- converted without encountering a L\(aq\\0\(aq,
-.\"O+ converted without encountering a null wide character (L\(aq\\0\(aq),
-.\"O or the length limit forces a stop.
-.\"O In this case \fI*src\fP is left pointing
-.\"O to the next wide character to be converted, and the number of bytes written
-.\"O to \fIdest\fP is returned.
-2. NULL ワイド文字 (L\(aq\\0\(aq) に出会わないで \fInwc\fP 個のワイド文字を
-変換した場合か、長さの制限によって変換が止められた場合。
-この場合には、\fI*src\fP は次に変換されるべきワイド文字を指した状態になり、
+2. NULL ワイド文字 (L\(aq\e0\(aq) に出会わないで \fInwc\fP 個のワイド文字を
+変換した場合か、長さの制限によって変換が止められた場合。 この場合には、\fI*src\fP は次に変換されるべきワイド文字を指した状態になり、
\fIdest\fP に書き込まれたバイト数が返される。
.PP
-.\"O 3. The wide-character string has been completely converted, including the
-.\"O- terminating L\(aq\\0\(aq (which has the side effect of bringing back \fI*ps\fP
-.\"O+ terminating null wide character (which has the side effect of bringing back \fI*ps\fP
-.\"O to the initial state).
-.\"O In this case \fI*src\fP is set to NULL, and the number
-.\"O- of bytes written to \fIdest\fP, excluding the terminating \(aq\\0\(aq byte, is
-.\"O+ of bytes written to \fIdest\fP, excluding the terminating null, is
-.\"O returned.
-3. ワイド文字列が終端の L\(aq\\0\(aq (これには \fI*ps\fP を初期状態に戻すと
-いう副作用がある)も含めて全て変換された場合。この場合には \fI*src\fP
-に NULL が設定され、\fIdest\fP に書き込まれたバイト数が返される
-(終端の \(aq\\0\(aq は数えない)。
+3. ワイド文字列が終端の L\(aq\e0\(aq (これには \fI*ps\fP を初期状態に戻すという副作用がある)
+も含めて全て変換された場合。この場合には \fI*src\fP に NULL が設定され、
+\fIdest\fP に書き込まれたバイト数が返される
+(終端の NULL バイト (\(aq\e0\(aq) は数えない)。
.PP
-.\"O If \fIdest\fP is NULL, \fIlen\fP is ignored,
-.\"O and the conversion proceeds as above,
-.\"O except that the converted bytes are not written out to memory, and that
-.\"O no destination length limit exists.
\fIdest\fP が NULL ならば \fIlen\fP は無視されて前述のように変換が行わ
-れるが、変換されたバイトデータはメモリに書き出されない点と、出力先の長
-さの制限がない点が異なる。
+れるが、変換されたバイトデータはメモリに書き出されない点と、出力先の長 さの制限がない点が異なる。
.PP
-.\"O In both of the above cases,
-.\"O if \fIps\fP is a NULL pointer, a static anonymous
-.\"O state only known to the wcsnrtombs function is used instead.
上記のいずれの場合も、\fIps\fP が NULL ポインタならば、wcsnrtombs 関数
だけが知っている静的な匿名の状態がシフト状態の代わりに用いられる。
.PP
-.\"O The programmer must ensure that there is room for at least \fIlen\fP bytes
-.\"O at \fIdest\fP.
-プログラマは少なくとも \fIlen\fP バイトの領域を \fIdest\fP に確保しな
-ければならない。
-.\"O .SH "RETURN VALUE"
+プログラマは少なくとも \fIlen\fP バイトの領域を \fIdest\fP に確保しな ければならない。
.SH 返り値
-.\"O The
-.\"O .BR wcsnrtombs ()
-.\"O function returns
-.\"O the number of bytes that make up the
-.\"O converted part of multibyte sequence,
-.\"O not including the terminating null.
-.BR wcsnrtombs ()
-関数は、変換して得られたマルチバイト列のバイト数を返
-す。これには終端の NULL は含まない。
-.\"O If a wide character was encountered which
-.\"O could not be converted,
-.\"O .I (size_t)\ \-1
-.\"O is returned, and \fIerrno\fP set to \fBEILSEQ\fP.
-変換できないワイド文字に出会った場合には
-.I (size_t)\ \-1
-が返され、 \fIerrno\fP に \fBEILSEQ\fP が設定される。
-.\"O .SH "CONFORMING TO"
+\fBwcsrtombs\fP() は、変換して得られたマルチバイト列のバイト数を返す。 これには終端の null バイトは含まれない。
+変換できないワイド文字に出会った場合には \fI(size_t)\ \-1\fP が返され、 \fIerrno\fP に \fBEILSEQ\fP が設定される。
.SH 準拠
-POSIX.1-2008.
-.\"O .SH NOTES
+POSIX.1\-2008.
.SH 注意
-.\"O The behavior of
-.\"O .BR wcsnrtombs ()
-.\"O depends on the
-.\"O .B LC_CTYPE
-.\"O category of the
-.\"O current locale.
-.BR wcsnrtombs ()
-の動作は現在のロケールの
-.B LC_CTYPE
-カテゴリに依存する。
+\fBwcsnrtombs\fP() の動作は現在のロケールの \fBLC_CTYPE\fP カテゴリに依存する。
.PP
-.\"O Passing NULL as \fIps\fP is not multithread safe.
\fIps\fP に NULL を渡した際の動作はマルチスレッドセーフでない。
-.\"O .SH "SEE ALSO"
.SH 関連項目
-.BR iconv (3),
-.BR wcsrtombs (3)
+\fBiconv\fP(3), \fBwcsrtombs\fP(3)
OSDN Git Service
