_vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l

Статья
06/09/2015

Записывает форматированные выходные данные с помощью указателя на список аргументов и включает спецификацию порядка, в котором используются аргументы.

int _vprintf_p(
   const char *format,
   va_list argptr 
);
int _vprintf_p_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vwprintf_p(
   const wchar_t *format,
   va_list argptr 
);
int _vwprintf_p_l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Параметры

format
Спецификация формата.
argptr
Указатель на список аргументов.
locale
Используемый языковой стандарт.

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

Возвращаемое значение

_vprintf_p и _vwprintf_p возвращают число записанных символов, не включая конечный нуль-символ, или отрицательное значение, если произошла ошибка вывода.

Заметки

Каждая из этих функций принимает в список аргументов указатель, затем форматирует и записывает указанные данные в stdout. Эти функции отличаются от vprintf_s и vwprintf_s только тем, что они поддерживают возможность задать порядок, в котором используются аргументы. Для получения дополнительной информации см. Позиционные параметры printf_p.

_vwprintf_p является версией _vprintf_p для расширенных символов; две функции ведут себя одинаково, если поток открывается в режиме ANSI. _vprintf_p в настоящее время не поддерживает вывод в поток в юникоде.

Версии этих функций с суффиксом _l идентичны за исключением того, что они используют переданный параметр языкового стандарта вместо языкового стандарта текущего потока.

Примечание по безопасности
Убедитесь, что format не является строкой, определяемой пользователем.Дополнительные сведения см. в разделе Как избежать переполнения буфера.

Если format - указатель на null, или если строка формата содержит недопустимые символы форматирования, то вызывается обработчик недопустимого параметра, как описано в разделе Проверка параметров. Если выполнение может быть продолжено, то функции возвращают -1 и устанавливают errno в EINVAL.

Универсальное текстовое сопоставление функций

Подпрограмма TCHAR.H	_UNICODE & _MBCS не определены	_MBCS определено	_UNICODE определено
_vtprintf_p	_vprintf_p	_vprintf_p	_vwprintf_p
_vtprintf_p_l	_vprintf_p_l	_vprintf_p_l	_vwprintf_p_l

Требования

Подпрограмма	Обязательный заголовок	Необязательные заголовки
_vprintf_p, _vprintf_p_l	<stdio.h> и <stdarg.h>	<varargs.h>*
_vwprintf_p, _vwprintf_p_l	<stdio.h> или <wchar.h> и <stdarg.h>	<varargs.h>*

* Требуется для обеспечения совместимости с UNIX V.

Консоль не поддерживается в приложениях Магазин Windows. Стандартные дескрипторы потока, связанные с консолью — stdin, stdout и stderr — необходимо перенаправить, чтобы функции C времени выполнения могли использовать их в приложениях Магазин Windows. Дополнительные сведения о совместимости см. в разделе Совместимость.