_vfprintf_p， _vfprintf_p_l， _vfwprintf_p， _vfwprintf_p_l

项目
02/21/2013

编写格式化输出使用指针参数列表，并且能够指定该命令参数用于格式字符串。

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 返回编写的字符数，不包括终止 null 字符) 或负值。

备注

这些功能中的每一个采用指向参数列表，然后布局和编写特定数据。 stream。这些函数与 _vfprint_s 和 _vfwprint_s 版本的唯一不同之处在于它们支持位置的参数。有关更多信息，请参见 printf_p位置参数。

_vfwprintf_p 是 _vprintf_p的宽字符版本;，如果流在 ANSI 模式下，中打开两个函数具有相同的行为。 _vprintf_p 当前不支持输出到 UNICODE 流。

这些功能的版本与 _l 后缀的相同，只不过它们使用区域设置参数而不是当前线程区域设置。

安全说明
确保 format 不是用户定义的字符串。有关更多信息，请参见避免缓冲区溢出。

如果 stream 或 format 是 null 指针，或者，如果格式字符串包含无效格式字符，无效参数调用处理程序，如参数验证所述。如果执行允许继续，函数返回 -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_end， va_start

printf_p位置参数

_fprintf_p， _fprintf_p_l， _fwprintf_p， _fwprintf_p_l

_vsprintf_p， _vsprintf_p_l， _vswprintf_p， _vswprintf_p_l

_sprintf_p， _sprintf_p_l， _swprintf_p， _swprintf_p_l