Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Записывают форматированные выходные данные, используя указатель на список аргументов, с возможностью указать порядок, в котором эти аргументы используются в строке формата.
Синтаксис
int _vfprintf_p(
FILE *stream,
const char *format,
va_list argptr
);
int _vfprintf_p_l(
FILE *stream,
const char *format,
_locale_t locale,
va_list argptr
);
int _vfwprintf_p(
FILE *stream,
const wchar_t *format,
va_list argptr
);
int _vfwprintf_p_l(
FILE *stream,
const wchar_t *format,
_locale_t locale,
va_list argptr
);
Параметры
stream
Указатель на структуру FILE .
format
Спецификация формата.
argptr
Указатель на список аргументов.
locale
Используемый языковой стандарт.
Дополнительные сведения см. в разделе "Синтаксис спецификации формата".
Возвращаемое значение
Функции _vfprintf_p и _vfwprintf_p возвращают число записанных символов, не включая конечный нуль-символ, или отрицательное значение, если произошла ошибка вывода.
Замечания
Каждая из этих функций принимает указатель на список аргументов, а затем форматирует и записывает указанные данные в stream. Эти функции отличаются от версий _vfprint_s и _vfwprint_s только в том, что они поддерживают позиционные параметры. Дополнительные сведения см. в разделе Позиционные параметры printf_p.
Функция _vfwprintf_p является версией функции _vprintf_p с расширенными символами; обе функции ведут себя одинаково, если поток открыт в режиме ANSI. Функция _vprintf_p на данный момент не поддерживает вывод данных в поток в кодировке Юникод.
Версии этих функций с суффиксом _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ссылкой.
Если или streamformat имеет значение NULL, или если строка форматирования содержит недопустимые символы форматирования, вызывается обработчик недопустимых параметров, как описано в разделе проверки параметров. Если продолжение выполнения разрешено, функции возвращают значение -1 и задают для errno значение EINVAL.
Сопоставления подпрограмм универсального текста
| Подпрограмма TCHAR.H |
_UNICODE и _MBCS не определен |
_MBCS Определенные |
_UNICODE Определенные |
|---|---|---|---|
_vftprintf_p |
_vfprintf_p |
_vfprintf_p |
_vfwprintf_p |
_vftprintf_p_l |
_vfprintf_p_l |
_vfprintf_p_l |
_vfwprintf_p_l |
Требования
| Маршрут | Обязательный заголовок | Необязательные заголовки |
|---|---|---|
_vfprintf_p, _vfprintf_p_l |
<stdio.h> и <stdarg.h> | <varargs.h>* |
_vfwprintf_p, _vfwprintf_p_l |
<stdio.h> или <wchar.h и >stdarg.h<> | <varargs.h>* |
* Требуется для совместимости UNIX V.
Дополнительные сведения о совместимости см. в разделе Совместимость.
См. также
Потоковый ввод-вывод
Функции vprintf
fprintf, , _fprintf_lfwprintf_fwprintf_l
printf, , _printf_lwprintf_wprintf_l
sprintf, , _sprintf_lswprintf, _swprintf_l__swprintf_l
va_arg, , va_copyva_endva_start
Позиционные параметры printf_p
_fprintf_p, , _fprintf_p_l_fwprintf_p_fwprintf_p_l
_vsprintf_p, , _vsprintf_p_l_vswprintf_p_vswprintf_p_l
_sprintf_p, , _sprintf_p_l_swprintf_p_swprintf_p_l