vprintf, _vprintf_l, vwprintf, _vwprintf_l

Статья
04/10/2013

Write форматировало выходные данные с помощью указателя в список аргументов.Более безопасные версии этих функций, доступных в разделе vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l.

int vprintf(
   const char *format,
   va_list argptr 
);
int _vprintf_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vwprintf(
   const wchar_t *format,
   va_list argptr 
);
int _vwprintf_l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Параметры

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

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

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

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

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

Заметки

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

версия vwprintf является vprintf; 2 функции ведут себя одинаково, если поток открывается в режиме ANSI.vprintf в настоящее время не поддерживает вывод в поток в юникоде.

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

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

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

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

Функция TCHAR.H	неопределенные _UNICODE & _MBCS	определенные _MBCS	Определение _UNICODE
_vtprintf	vprintf	vprintf	vwprintf
_vtprintf_l	_vprintf_l	_vprintf_l	_vwprintf_l

Требования

Функция	Требуемый заголовок	Необязательные заголовки
vprintf, _vprintf_l	<stdio.h> и <stdarg.h>	<varargs.h>*
vwprintf, _vwprintf_l	<stdio.h> или <wchar.h>, и <stdarg.h>	<varargs.h>*

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

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