vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l

Статья
06/09/2015

Записывает форматированные выходные данные с помощью указателя на список аргументов. В этих версиях vprintf, _vprintf_l, vwprintf, _vwprintf_l усовершенствована безопасность, как описано в разделе Функции безопасности в CRT.

int vprintf_s(
   const char *format,
   va_list argptr 
);
int _vprintf_s_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vwprintf_s(
   const wchar_t *format,
   va_list argptr 
);
int _vwprintf_s_l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Параметры

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

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

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

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

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

Заметки

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

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

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

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

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

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

Подпрограмма TCHAR.H	_UNICODE & _MBCS не определены	_MBCS определено	_UNICODE определено
_vtprintf_s	vprintf_s	vprintf_s	vwprintf_s
_vtprintf_s_l	_vprintf_s_l	_vprintf_s_l	_vwprintf_s_l

Требования

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

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

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