vprintf， _vprintf_l， vwprintf， _vwprintf_l

项目
04/10/2013

编写格式化输出使用指针参数列表。这些功能的更安全的版本可用，请参见 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 返回编写的字符数，不包括终止 null 字符) 或负值。如果 format 是 null 指针，或者，如果格式字符串包含无效格式字符，无效参数调用处理程序，如参数验证所述。如果执行允许继续，函数返回 -1 并将 errno 到 EINVAL。

有关这些属性和其他错误代码的信息，请参见 _doserrno、errno、_sys_errlist 和_sys_nerr。

备注

这些功能中的每一个采用指向参数列表，然后布局和编写特定数据。stdout。

vwprintf 是 vprintf的宽字符版本；，如果流在 ANSI 模式下，中打开两个函数具有相同的行为。 vprintf 当前不支持输出到 UNICODE 流。

这些功能的版本与 _l 后缀的相同，只不过它们使用区域设置参数而不是当前线程区域设置。

安全说明
确保 format 不是用户定义的字符串。有关更多信息，请参见避免缓冲区溢出。请注意检测到无效格式字符串并在错误的结果。