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返回编写的字符数,不包括终止空字符或负值。 如果 format 是空指针,或者,如果格式字符串包含无效格式字符,无效参数调用处理程序,如 参数验证所述。 如果允许继续执行,则这些函数返回-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 应用商店 应用程序中不受支持。 与控制台 stdin、stdout 和 stderr 关联的标准流句柄必须重定向,然后 C 运行时函数才可以在 Windows 应用商店 应用程序中使用它们。 有关兼容性的更多信息,请参见兼容性。
.NET Framework 等效项
请参见
参考
fprintf、_fprintf_l、fwprintf、_fwprintf_l
printf、_printf_l、wprintf、_wprintf_l