_vprintf_p、_vprintf_p_l、_vwprintf_p、_vwprintf_p_l

编写格式化输出使用指针参数列表,规范参数使用中的顺序。

int _vprintf_p(
   const char *format,
   va_list argptr 
);
int _vprintf_p_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vwprintf_p(
   const wchar_t *format,
   va_list argptr 
);
int _vwprintf_p_l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

参数

  • format
    格式规范。

  • argptr
    指向参数列表的指针。

  • locale
    要使用的区域设置。

有关更多信息,请参见格式规范

返回值

如果输出有错误,_vprintf_p和 _vwprintf_p返回编写的字符数,不包括终止空字符或负值。

备注

每个函数通过指针指向参数列表,然后布局和编写特定数据到stdout。 这些函数与 vprintf_s 和 vwprintf_s 唯一不同之处在于它们支持能够指定参数的排序。 有关详细信息,请参阅printf_p 位置参数

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

这些带有 _l 后缀的函数的版本相同,只不过它们使用传递的区域设置参数而不是当前线程区域设置。

安全说明安全说明

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

如果 format 是空指针,或者,如果格式字符串包含无效格式字符,无效参数调用处理程序,如 参数验证所述。 如果允许继续执行,则这些函数返回-1,并将 errno设置为EINVAL。

一般文本例程映射

TCHAR.H 例程

未定义 _UNICODE & _MBCS

已定义 _MBCS

已定义 _UNICODE

_vtprintf_p

_vprintf_p

_vprintf_p

_vwprintf_p

_vtprintf_p_l

_vprintf_p_l

_vprintf_p_l

_vwprintf_p_l

要求

例程

必需的标头

可选标头

_vprintf_p, _vprintf_p_l

<stdio.h> 和 <stdarg.h>

<varargs.h>*

_vwprintf_p, _vwprintf_p_l

<stdio.h> 或 <wchar.h> 和 <stdarg.h>

<varargs.h>*

* 仅对 UNIX V 兼容性是必需的。

控制台在 Windows 应用商店 应用程序中不受支持。 与控制台 stdin、stdout 和 stderr 关联的标准流句柄必须重定向,然后 C 运行时函数才可以在 Windows 应用商店 应用程序中使用它们。 有关兼容性的更多信息,请参见兼容性

.NET Framework 等效项

System::Console::Write

请参见

参考

流 I/O

vprintf 函数

_fprintf_p、_fprintf_p_l、_fwprintf_p、_fwprintf_p_l

_printf_p、_printf_p_l、_wprintf_p、_wprintf_p_l

_sprintf_p、_sprintf_p_l、_swprintf_p、_swprintf_p_l

vsprintf_s、_vsprintf_s_l、vswprintf_s、_vswprintf_s_l

va_arg、va_copy、va_end、va_start

_vfprintf_p、_vfprintf_p_l、_vfwprintf_p、_vfwprintf_p_l

_printf_p、_printf_p_l、_wprintf_p、_wprintf_p_l

printf_p 位置参数