_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。有关更多信息,请参见平台调用示例

请参见

参考

流 I/O

vprintf 函数

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

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