vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l
编写格式化输出使用指针参数列表。 这些是 vprintf, _vprintf_l, vwprintf, _vwprintf_l 的版本与安全增强如 CRT中的安全功能所述。
int vprintf_s(
const char *format,
va_list argptr
);
int _vprintf_s_l(
const char *format,
locale_t locale,
va_list argptr
);
int vwprintf_s(
const wchar_t *format,
va_list argptr
);
int _vwprintf_s_l(
const wchar_t *format,
locale_t locale,
va_list argptr
);
参数
format
格式规范。argptr
列表的指针参数。locale
使用的区域设置。
有关更多信息,请参见 格式规范。
返回值
如果输出错误,vprintf_s 和 vwprintf_s 返回编写的字符数,不包括终止 null 字符) 或负值。 如果 format 是 null 指针,或者,如果格式字符串包含无效格式字符,无效参数调用处理程序,如 参数验证所述。 如果执行允许继续,函数返回 -1 并将 errno 到 EINVAL。
有关这些属性和其他错误代码的信息,请参见 _doserrno、errno、_sys_errlist 和_sys_nerr。
备注
这些功能中的每一个采用指向参数列表,然后布局和编写特定数据。stdout。
这些函数的安全版本与 vprintf 和 vwprintf 只是在于安全版本检查格式字符串包含格式无效字符。
vwprintf_s 是 vprintf_s的宽字符版本;,如果流在 ANSI 模式下,中打开两个函数具有相同的行为。 vprintf_s 当前不支持输出到 UNICODE 流。
这些功能的版本与 _l 后缀的相同,只不过它们使用区域设置参数而不是当前线程区域设置。
安全说明 |
---|
确保 format 不是用户定义的字符串。有关更多信息,请参见 避免缓冲区溢出。 |
一般文本例程映射
TCHAR.H 实例 |
未定义的_UNICODE & _MBCS |
定义的_MBCS |
定义的_UNICODE |
---|---|---|---|
_vtprintf_s |
vprintf_s |
vprintf_s |
vwprintf_s |
_vtprintf_s_l |
_vprintf_s_l |
_vprintf_s_l |
_vwprintf_s_l |
要求
实例 |
必需的标头 |
选项标头 |
---|---|---|
vprintf_s, _vprintf_s_l |
<stdio.h> 和 <stdarg.h> |
<varargs.h>* |
vwprintf_s, _vwprintf_s_l |
<stdio.h> 或 <wchar.h>和 <stdarg.h> |
<varargs.h>* |
*仅对 UNIX v 兼容性。
控件个在 Windows 应用商店 apps 不受支持。 标准流处理与控件个,stdin,stdout和 stderr,在 C 运行时函数在 Windows 应用商店 apps 之前,可以使用它们必须重定向。 有关其他的兼容性信息,请参见中介绍的 兼容性。
.NET Framework 等效项
请参见
参考
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l