_vscprintf_p、_vscprintf_p_l、_vscwprintf_p、_vscwprintf_p_l

项目
06/09/2015

返回字符在格式化字符串中使用一个指向参数列表的数字，并可以指定在已使用参数中的顺序。

int _vscprintf_p(
   const char *format,
   va_list argptr 
);
int _vscprintf_p _l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vscwprintf_p (
   const wchar_t *format,
   va_list argptr 
);
int _vscwprintf_p _l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

参数

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

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

返回值

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

备注

这些函数与 _vscprintf 和 _vscwprintf 唯一不同之处在于它们支持能够指定参数的排序。有关详细信息，请参阅printf_p 位置参数。

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

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

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