vfprintf_s、 _vfprintf_s_l、 vfwprintf_s、 _vfwprintf_s_l

引数リストへのポインターを使用して、書式付き出力を書き込みます。 これらの関数は、「CRT のSecurity 機能」で説明されているように、セキュリティが強化されたvfprintf、_vfprintf_l、vfwprintf、_vfwprintf_lのバージョンです。

構文

int vfprintf_s(
   FILE *stream,
   const char *format,
   va_list argptr
);
int _vfprintf_s_l(
   FILE *stream,
   const char *format,
   _locale_t locale,
   va_list argptr
);
int vfwprintf_s(
   FILE *stream,
   const wchar_t *format,
   va_list argptr
);
int _vfwprintf_s_l(
   FILE *stream,
   const wchar_t *format,
   _locale_t locale,
   va_list argptr
);

パラメーター

stream
FILE 構造体へのポインター。

format
書式の指定。

argptr
引数リストへのポインター。

locale
使用するロケール。

詳細については、「書式指定構文」を参照してください。

戻り値

vfprintf_s 関数と vfwprintf_s 関数は、書き込まれた文字数を返します。終端の null 文字は含まれません。出力エラーが発生した場合は、負の値を返します。 streamまたはformatが null ポインターの場合、または書式指定文字列に無効な書式指定文字が含まれている場合は、「パラメーターの検証で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、関数は -1 を返し、errno を EINVAL に設定します。

これらのエラー コードおよびその他のエラー コードの詳細については、「errno、_doserrno、_sys_errlist、_sys_nerr」を参照してください。

解説

これらの関数は、引数リストへのポインターを使用して、指定されたデータを書式化して stream に書き込みます。

セキュリティが強化されたバージョンは format 文字列に有効な書式指定文字が含まれていることを確認する点を除いて、セキュリティが万全でないバージョンと同じです。

vfwprintf_s は vfprintf_s のワイド文字バージョンであり、ストリームが ANSI モードで開いている場合、この 2 つの関数の動作は同じです。 vfprintf_s では、UNICODE ストリームへの出力はサポートされていません。

これらの関数のうち _l サフィックスが付けられたバージョンは、現在のスレッド ロケールの代わりに渡されたロケール パラメーターを使用する点を除いて同じです。

重要

format にユーザー定義の文字列を指定しないでください。 詳細については、「バッファー オーバーランの回避」を参照してください。 Windows 10 バージョン 2004 (ビルド 19041) 以降の printf ファミリの関数では、丸め処理の IEEE 754 の規則に従って、正確に表現可能な浮動小数点数が出力されます。 以前のバージョンの Windows では、"5" で終わる正確に表現可能な浮動小数点数は常に切り上げられていました。 IEEE 754 では、最も近い偶数に丸める ("銀行型丸め" とも呼ばれます) 必要があることが示されています。 たとえば、printf("%1.0f", 1.5) と printf("%1.0f", 2.5) の両方を 2 に丸める必要があります。 以前は、1.5 は 2 に、2.5 は 3 に丸められていました。 この変更は、正確に表現可能な数値にのみ影響します。 たとえば、2.35 (メモリで表される場合は 2.35000000000000008 に近い) は、2.4 に切り上げられます。 これらの関数によって実行される丸め処理では、fesetround によって設定された浮動小数点丸めモードにも従うようになりました。 以前は、丸め処理には常に FE_TONEAREST の動作が選択されていました。 この変更は、Visual Studio 2019 バージョン 16.2 以降を使用してビルドされたプログラムにのみ影響します。 従来の浮動小数点丸め動作を使用するには、'legacy_stdio_float_rounding.obj' にリンクします。

汎用テキスト ルーチンのマップ

TCHAR.H のルーチン	_UNICODE と _MBCS が定義されていない	_MBCS が定義されている	_UNICODE が定義されている
_vftprintf_s	vfprintf_s	vfprintf_s	vfwprintf_s
_vftprintf_s_l	_vfprintf_s_l	_vfprintf_s_l	_vfwprintf_s_l

要件

ルーチンによって返される値	必須ヘッダー	省略可能なヘッダー
vfprintf_s, _vfprintf_s_l	<stdio.h> および <stdarg.h>	<varargs.h>*
vfwprintf_s, _vfwprintf_s_l	<stdio.h> または <wchar.h>、および <stdarg.h>	<varargs.h>*

* UNIX V の互換性のために必要です。

互換性の詳細については、「 Compatibility」を参照してください。

関連項目

ストリーム入出力
vprintf 関数
fprintf、 _fprintf_l、 fwprintf、 _fwprintf_l
printf、 _printf_l、 wprintf、 _wprintf_l
sprintf、 _sprintf_l、 swprintf、 _swprintf_l、 __swprintf_l
va_arg、 va_copy、 va_end、 va_start