名前

       wprintf,  fwprintf, swprintf, vwprintf, vfwprintf, vswprintf - ワイド文字を フォーマットし
       て出力する

書式

       #include <stdio.h>
       #include <wchar.h>

       int wprintf(const wchar_t *format, ...);
       int fwprintf(FILE *stream, const wchar_t *format, ...);
       int swprintf(wchar_t *wcs, size_t maxlen,
                    const wchar_t *format, ...);

       int vwprintf(const wchar_t *format, va_list args);
       int vfwprintf(FILE *stream, const wchar_t *format, va_list args);
       int vswprintf(wchar_t *wcs, size_t maxlen,
                     const wchar_t *format, va_list args);

   glibc 向けの機能検査マクロの要件 (feature_test_macros(7)  参照):

       上記の全ての関数:
           _XOPEN_SOURCE >= 500 || _ISOC99_SOURCE ||
           _POSIX_C_SOURCE >= 200112L;
           or cc -std=c99

説明

       wprintf()  ファミリーの関数は printf(3)  ファミリーの関数の ワイド文字版である。これらはワ
       イド文字をフォーマットして出力する。

       wprintf()  と vwprintf()  関数は stdout に出力を行なう。 stdout がバイト単位入出力であって
       はいけない。より詳しい説明は fwide(3)  を参照すること。

       fwprintf()  と vfwprintf()  関数は stream にワイド文字出力 を行なう。 stream  がバイト単位
       入出力であってはいけない。 より詳しい説明は fwide(3)  を参照すること。

       swprintf()   と vswprintf()  関数はワイド文字の配列に ワイド文字出力を行なう。プログラマー
       は wcs に最低でも maxlen 文字のワイド文字を出力できる空きがあることを保証しなければ ならな
       い。

       これらの関数は printf(3), vprintf(3), fprintf(3), vfprintf(3), sprintf(3), vsprintf(3)  関
       数に似ているが以下の 点で異っている。

       •      format がワイド文字列で与えられる。

       •      出力がバイトではなくワイド文字で構成される。

       •      swprintf()  と vswprintf()  は maxlen 引き数を取るが、 sprintf()  と vsprintf()  は
              取らない (snprintf()  と vsnprintf()  は maxlen 引き数を取るが これらの関数が Linux
              では、バッファーが溢れた場合でも -1 を返さない)。

       c と s 変換文字の扱いが異っている:

       c      もし l 修飾子が存在しない場合は int 引き数は btowc(3)  関数によってワイド文字に変換
              される。そして結果のワイド文字が出力される。  l 修飾子が存在する場合は wint_t (ワイ
              ド文字)引き数が出力される。

       s      もし l 修飾子が存在しない場合、 const char * 引き数は初期状態より始まるマルチバイト
              文字列を含んだ char 型の配列へのポインタ(文字列へのポインタ)とみなされる。 配列の文
              字は(最初のバイト前に初期状態で変換を開始し、それぞれの文字を  mbrtowc(3)    関数に
              よって)ワイド文字へと変換される。結果のワイド文字は終端の ナルワイド文字 (L'\0') の
              手前までが書き込まれる。精度(precision)が指定された  場合、指定された数字を超えるワ
              イド文字は書き込まれない。精度は  書き込まれる バイト 数や 画面上の位置 ではなく ワ
              イド文字 の数を指定することに注意すること。  精度がない場合には配列の終端にナルバイ
              ト ('\0') を含む必要がある。 精度を指定する場合には、配列の最後に到着する前に変換さ
              れたワイド文字の   数がそれに到達するよう、精度は十分に小さな数でなければならない。
              もし  l 修飾子が存在する場合、 const wchar_t * 引き数はワイド文字の配列へのポインタ
              とみなされる。 配列のワイド文字列は終端のナルワイド文字の手間まで出力される。  もし
              精度が指定された場合には指定された精度以上の文字は出力されない。 精度を指定しない場
              合には終端のナルワイド文字を含む必要がある。 精度を指定する場合にはそれはワイド文字
              の配列の大きさよりも小さくな ければならない。

返り値

       これらの関数は書き込まれたワイド文字の文字数を返す。  swprintf()  と vswprintf()  関数の場
       合は 終端のナルワイド文字は含まない。エラーが起こった場合は -1 を返す。

準拠

       C99.

注意

       wprintf()  等の動作は現在のロケールの LC_CTYPE カテゴリに依存している。

       format 文字列が ASCII 以外のワイド文字を含んでいる場合、 実行時のロケールの LC_CTYPE  カテ
       ゴリがコンパイル時の  LC_CTYPE  カテゴリと  一致している場合にのみプログラムは正常に動作す
       る。これは wchar_t の表現がロケールやプラットホームに依存していることに原因がある。 (glibc
       ではワイド文字として Unicode (ISO-10646) のコードポイントを 使用している。他のプラットホー
       ムではそうではない。同様に ISO C99 の  \unnnn  形式の汎用文字名称はこの問題を解決しない。)
       このため国際化されたプログラムでは format 文字列を ASCII ワイド 文字のみにするか、実行時に
       国際化された方法で構成する必要がある (例えば gettext()  と iconv()  や mbstowcs()   を組み
       合わて使用する)。

関連項目

       fprintf(3), fputwc(3), fwide(3), printf(3), snprintf(3)

この文書について

       この  man ページは Linux man-pages プロジェクトのリリース 3.65 の一部 である。プロジェクト
       の説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。