vsprintf_s、vswprintf_s

stdio.h：インデックス への移動

ヘッダー ファイル

stdio.h

カテゴリ

書式付き入出力関数

プロトタイプ

int vsprintf_s(char * restrict s, rsize_t n, const char * restrict format, va_list arg);

int vswprintf_s(wchar_t * restrict s, rsize_t n, const wchar_t * restrict format, va_list arg);

説明

vsprintf、vswprintf の代わりとなるもので、セキュリティ機能が強化されています。

v...printf 関数群は、...printf 関数群の代替エントリ ポイントとして知られています。 対応する ...printf 関数とちょうど同じ動作をしますが、引数リストではなく、引数リストへのポインタを受け取ります。

vsprintf_s は、一連の引数へのポインタを受け取り、format が指す書式文字列に含まれる各形式指定子に適用して、書式付きデータを文字列に出力します。 形式指定子の数は、引数の数に一致させる必要があります。

vfprintf_s は、vsprintf、vswprintf と同等のものですが、s の妥当性に関するパラメータ n と実行時制約、format、および %s 形式指定子に対応する arg の項目が追加されています（前述したように、arg のすべての項目は NULL ポインタであってはなりません）。

実行時制約違反が発生した場合、vsprintf_s は s[0] に '\0' を設定します。

vsnprintf_s、vsnwprintf_s とは異なり、vsprintf_s は、結果を s が指す配列に合わせて切り詰めません。 代わりに、実行時制約違反が発生します。

戻り値

vsprintf_s は、出力文字数を返します。 エラーの場合、vsprintf_s は負の値を返します。 それ以外の場合、vsprintf_s は 0 を返します。

例

#include <stdio.h>
#include <conio.h>
#include <stdarg.h>
char buffer[80];
int vspf(char *fmt, ...)
{
   va_list argptr;
   int cnt;
   va_start(argptr, fmt);
   cnt = vsprintf_s(buffer, 70,fmt, argptr);
   va_end(argptr);
   return(cnt);
}
int main(void)
{
   int inumber = 30;
   float fnumber = 90.0;
   char string[4] = "abc";
   vspf("%d %f %s", inumber, fnumber, string);
   printf_s("%s\n", buffer);
   return 0;
}

移植性

	POSIX	Win32	ANSI C	ANSI C++
vsprintf_s	+	+	+	+
vswprintf_s		+	+	+

関連項目

• C/C++ の書式指定子
• セキュア C ライブラリ