vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l

 

Самая актуальная документация по Visual Studio 2017: Документация по Visual Studio 2017.

Записывают форматированные выходные данные с помощью указателя на список аргументов. Существуют более безопасные версии этих функций; в разделе vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l.

int vfprintf(  
   FILE *stream,  
   const char *format,  
   va_list argptr   
);  
int _vfprintf_l(  
   FILE *stream,  
   const char *format,  
   locale_t locale,  
   va_list argptr   
);  
int vfwprintf(  
   FILE *stream,  
   const wchar_t *format,  
   va_list argptr   
);  
int _vfwprintf_l(  
   FILE *stream,  
   const wchar_t *format,  
   locale_t locale,  
   va_list argptr   
);  

Параметры

stream
Указатель на структуру FILE.

format
Спецификация формата.

argptr
Указатель на список аргументов.

locale
Используемый языковой стандарт.

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

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

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

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

vfwprintf представляет версию расширенных символов vfprintf; две функции ведут себя одинаково при открытии потока в режиме ANSI. vfprintf не поддерживает выходные данные в поток в кодировке ЮНИКОД.

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

System_CAPS_ICON_important.jpg Важно

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

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

Подпрограмма TCHAR.H_UNICODE и _MBCS не определены_MBCS определено_UNICODE определено
_vftprintfvfprintfvfprintfvfwprintf
_vftprintf_l_vfprintf_l_vfprintf_l_vfwprintf_l
ПодпрограммаОбязательный заголовокНеобязательные заголовки
vfprintf, _vfprintf_l<stdio.h> и <stdarg.h><varargs.h>*
vfwprintf, _vfwprintf_l<stdio.h> или <wchar.h> и <stdarg.h><varargs.h>*

* Необходим для совместимости UNIX V.

Дополнительные сведения о совместимости, в разделе совместимости во введении.

Неприменимо. Для вызова стандартной функции C используйте PInvoke. Дополнительные сведения см. в разделе примеры вызова неуправляемого кода платформы.

Поток ввода-вывода
Функции vprintf
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l
sprintf _sprintf_l, swprintf, _swprintf_l, __swprintf_l
va_arg, va_copy, va_end, va_start

Показ: