vprintf、_vprintf_l、vwprintf、_vwprintf_l

项目
06/09/2015

编写使用指针参数列表的格式化输出。提供这些函数的更多安全版本；请参见 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的宽字符版本；如果流在 ANSI 模式下是公开的则两个函数具有相同行为。 vprintf 当前不支持输出到 UNICODE 流。

这些带有 _l 后缀的函数的版本相同，只不过它们使用传递的区域设置参数而不是当前线程区域设置。

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