OpenVMS マニュアル

swprintf

ワイド文字書式文字列の制御下で，ワイド文字の配列に出力を書き込みます。

形式

#include <wchar.h>

int swprintf (wchar_t *s, size_t n, const wchar_t *format, ...);

引数

s

結果として得られるワイド文字シーケンスへのポインタ。

n

s がポイントする配列に書き込むことができるワイド文字の数の最大値。終端の null ワイド文字を含みます。

format

書式指定を含んだワイド文字列へのポインタ。書式指定と変換指定，およびその対応する引数については，『HP C ランタイム・ライブラリ・リファレンス・マニュアル(上巻)』第 2 章を参照してください。

...

結果として得られる型が，書式指定で与えられた変換指定に対応しているオプションの式。

変換指定が与えられなかった場合，出力ソースは省略することができます。そうでない場合は，関数呼び出しは変換指定と同じ数の出力ソースを持っていなくてはならず，変換指定は出力ソースの型と一致していなくてはなりません。

変換指定は，左から右の順序で出力ソースと照合されます。余分な出力ポインタがある場合には，無視されます。

説明

swprintf関数は，第 1 引数がストリームではなくワイド文字の配列を指定しているという点を除けば， fwprintf関数と等価です。

書き込まれるワイド文字の数は，終端の null ワイド文字を含めて， n 個以下です。終端の null ワイド文字は (n が 0 でなければ) つねに追加されます。

fwprintfも参照してください。

戻り値

x	書き込まれたワイド文字の数。終端の null ワイド文字は含みません。
負の値	エラーを示します。 n 個以上のワイド文字の書き込みが要求されたか，変換エラーが発生しました。後者の場合， errno は EILSEQ に設定されます。