_vfprintf_p、_vfprintf_p_l、_vfwprintf_p、_vfwprintf_p_l
使用指针编写格式化输出的参数列表,能够指定使用格式字符串参数的排序。
int _vfprintf_p(
FILE *stream,
const char *format,
va_list argptr
);
int _vfprintf_p_l(
FILE *stream,
const char *format,
locale_t locale,
va_list argptr
);
int _vfwprintf_p(
FILE *stream,
const wchar_t *format,
va_list argptr
);
int _vfwprintf_p_l(
FILE *stream,
const wchar_t *format,
locale_t locale,
va_list argptr
);
参数
stream
指向 FILE 结构的指针。format
格式规范。argptr
指向参数列表的指针。locale
要使用的区域设置。
有关更多信息,请参见格式规范。
返回值
如果输出有错误,_vfprintf_p和 _vfwprintf_p返回编写的字符数,不包括终止空字符或负值。
备注
每个函数通过指针指向参数列表,然后布局和编写特定数据到stream。 这些函数与 _vfprint_s 和 _vfwprint_s的差异仅在于它们支持位置参数。 有关详细信息,请参阅printf_p 位置参数。
_vfwprintf_p 是 _vprintf_p的宽字符版本;如果流在 ANSI 模式下是公开的则两个函数具有相同行为。 _vprintf_p 当前不支持输出到 UNICODE 流。
这些带有 _l 后缀的函数的版本相同,只不过它们使用传递的区域设置参数而不是当前线程区域设置。
安全说明 |
---|
确保 format 不是用户定义的字符串。有关更多信息,请参见避免缓冲区溢出。 |
如果 stream或format 是空指针,或者,如果格式字符串包含无效格式字符,无效参数调用处理程序,如 参数验证 所述。 如果允许继续执行,则这些函数返回-1,并将errno设置为EINVAL。
一般文本例程映射
TCHAR.H 例程 |
未定义的 _UNICODE & 和 _MBCS |
已定义 _MBCS |
已定义 _UNICODE |
---|---|---|---|
_vftprintf_p |
_vfprintf_p |
_vfprintf_p |
_vfwprintf_p |
_vftprintf_p_l |
_vfprintf_p_l |
_vfprintf_p_l |
_vfwprintf_p_l |
要求
例程 |
必需的标头 |
可选标头 |
---|---|---|
_vfprintf_p, _vfprintf_p_l |
<stdio.h> 和 <stdarg.h> |
<varargs.h>* |
_vfwprintf_p, _vfwprintf_p_l |
<stdio.h> 或 <wchar.h> 和 <stdarg.h> |
<varargs.h>* |
* 仅对 UNIX V 兼容性是必需的。
有关其他兼容性信息,请参见“简介”中的兼容性。
.NET Framework 等效项
不适用。若要调用标准 C 函数,请使用 PInvoke。有关更多信息,请参见平台调用示例。
请参见
参考
fprintf、_fprintf_l、fwprintf、_fwprintf_l
printf、_printf_l、wprintf、_wprintf_l
sprintf、_sprintf_l、swprintf、_swprintf_l、__swprintf_l
va_arg、va_copy、va_end、va_start
_fprintf_p、_fprintf_p_l、_fwprintf_p、_fwprintf_p_l