vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l

Статья
06/09/2015

Записывают форматированные выходные данные с помощью указателя на список аргументов. Здесь представлены версии vfprintf, _vfprintf_l, vfwprintf, _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 возвращают число записанных символов, не включая конечный нуль-символ, или отрицательное значение, если произошла ошибка вывода. Если stream или format — указатель на null, или если строка формата содержит недопустимые символы форматирования, то вызывается обработчик недопустимого параметра, как описано в разделе Проверка параметров. Если выполнение может быть продолжено, то функции возвращают -1 и устанавливают errno в EINVAL.

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

Заметки

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

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

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

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

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