vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l

Записывают форматированные выходные данные с помощью указателя на список аргументов. Эти функции — это версии vfprintf, vfwprintf_vfprintf_lс улучшениями безопасности, _vfwprintf_l как описано в функциях безопасности в CRT.

Синтаксис

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 возвращают число записанных символов, не включая конечный нуль-символ, или отрицательное значение, если произошла ошибка вывода. Если или streamformat имеет значение NULL, или если строка форматирования содержит недопустимые символы форматирования, вызывается обработчик недопустимых параметров, как описано в разделе проверки параметров. Если продолжение выполнения разрешено, функции возвращают значение -1 и задают для errno значение EINVAL.

Дополнительные сведения об этих и других кодах ошибок см. в разделе errno, _doserrno_sys_errlistи _sys_nerr.

Замечания

Каждая из этих функций принимает указатель на список аргументов, а затем форматирует и записывает указанные данные в stream.

Эти функции отличаются от небезопасных версий только тем, что безопасные версии проверяют, что строка format содержит допустимые символы форматирования.

Функция vfwprintf_s является версией функции vfprintf_s с расширенными символами; обе функции ведут себя одинаково, если поток открыт в режиме ANSI. Функция vfprintf_s на данный момент не поддерживает вывод данных в поток в кодировке Юникод.

Версии этих функций с суффиксом _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,3500000000000000008) продолжает округляется до 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.

Дополнительные сведения о совместимости см. в разделе Совместимость.

См. также

Потоковый ввод-вывод
Функции 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