_vscprintf、_vscprintf_l、_vscwprintf、_vscwprintf_l

项目
06/09/2015

返回的字符数量的格式字符串中使用指针到参数列表。

int _vscprintf(
   const char *format,
   va_list argptr 
);
int _vscprintf_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vscwprintf(
   const wchar_t *format,
   va_list argptr 
);
int _vscwprintf_l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

参数

format
窗体控件字符串。
argptr
指向参数列表的指针。
locale
要使用的区域设置。

有关更多信息，请参见格式规范。

返回值

_vscprintf 返回产生的字符数，如果该字符串所指向的使用指定的格式代码被打印或发送到一个文件或缓冲区的参数列表。返回的值不包括终止空字符。 _vscwprintf 为宽字符实现相同的函数。

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

如果 format 是空指针，则会调用无效参数处理程序，如参数验证所述。如果允许继续执行，则这些函数返回-1，并将errno设置为EINVAL。

备注

每个 argument（如果有）根据 format 中相应的格式规范进行转换。该格式包括普通字符，其形式和函数与 printf 的 format 参数相同。

安全说明
请确保，如果 format 是用户定义的字符串，则它是终止 null 并具有正确的参数数量和类型。有关更多信息，请参见避免缓冲区溢出。