(ワイド文字)引き数が出力される。
.TP
\fBs\fP
-If no \fBl\fP modifier is present: The \fIconst\ char\ *\fP argument is expected
-to be a pointer to an array of character type (pointer to a string)
-containing a multibyte character sequence beginning in the initial shift
-state. Characters from the array are converted to wide characters (each by
-a call to the \fBmbrtowc\fP(3) function with a conversion state starting in
-the initial state before the first byte). The resulting wide characters are
-written up to (but not including) the terminating null wide character
-(L\(aq\e0\(aq). If a precision is specified, no more wide characters than
-the number specified are written. Note that the precision determines the
-number of \fIwide characters\fP written, not the number of \fIbytes\fP or \fIscreen
-positions\fP. The array must contain a terminating null byte (\(aq\e0\(aq),
-unless a precision is given and it is so small that the number of converted
-wide characters reaches it before the end of the array is reached. If an
-\fBl\fP modifier is present: The \fIconst\ wchar_t\ *\fP argument is expected to
-be a pointer to an array of wide characters. Wide characters from the array
-are written up to (but not including) a terminating null wide character. If
-a precision is specified, no more than the number specified are written.
-The array must contain a terminating null wide character, unless a precision
-is given and it is smaller than or equal to the number of wide characters in
-the array.
+もし \fBl\fP 修飾子が存在しない場合、 \fIconst\ char\ *\fP 引き数は初期状態より始まるマルチバイト文字列を含んだ char
+型の配列へのポインタ(文字列へのポインタ)とみなされる。 配列の文字は(最初のバイト前に初期状態で変換を開始し、それぞれの文字を
+\fBmbrtowc\fP(3) 関数によって)ワイド文字へと変換される。結果のワイド文字は終端の ナルワイド文字 (L\(aq\e0\(aq)
+の手前までが書き込まれる。精度(precision)が指定された 場合、指定された数字を超えるワイド文字は書き込まれない。精度は 書き込まれる
+\fIバイト\fP 数や \fI画面上の位置\fP ではなく \fIワイド文字\fP の数を指定することに注意すること。 精度がない場合には配列の終端にナルバイト
+(\(aq\e0\(aq) を含む必要がある。 精度を指定する場合には、配列の最後に到着する前に変換されたワイド文字の
+数がそれに到達するよう、精度は十分に小さな数でなければならない。 もし \fBl\fP 修飾子が存在する場合、 \fIconst\ wchar_t\ *\fP
+引き数はワイド文字の配列へのポインタとみなされる。 配列のワイド文字列は終端のナルワイド文字の手間まで出力される。
+もし精度が指定された場合には指定された精度以上の文字は出力されない。 精度を指定しない場合には終端のナルワイド文字を含む必要がある。
+精度を指定する場合にはそれはワイド文字の配列の大きさよりも小さくな ければならない。
.SH 返り値
これらの関数は書き込まれたワイド文字の文字数を返す。 \fBswprintf\fP() と \fBvswprintf\fP() 関数の場合は
終端のナルワイド文字は含まない。エラーが起こった場合は \-1 を返す。
OSDN Git Service
