_vcprintf_p， _vcprintf_p_l， _vcwprintf_p， _vcwprintf_p_l

编写格式化输出到控件个使用指针参数列表，并支持在格式字符串的位置参数。

重要

此 API 不能在 Windows 运行时执行的应用程序。有关更多信息，请参见 CRT 函数不支持与 /ZW。

int _vcprintf_p(
   const char* format,
   va_list argptr
);
int _vcprintf_p_l(
   const char* format,
   locale_t locale,
   va_list argptr
);
int _vcwprintf_p(
   const wchar_t* format,
   va_list argptr
);
int _vcwprintf_p_l(
   const wchar_t* format,
   locale_t locale,
   va_list argptr
);

参数

• format
  格式规范。

• argptr
  给参数列表的指针。

• locale
  使用的区域设置。

有关更多信息，请参见格式规范语法：printf 和 wprintf 函数。

返回值

编写字符数或负值，如果输出错误。 如果 format 是 null 指针，无效参数调用处理程序，如 参数验证所述。 如果执行允许继续，errno 设置为 EINVAL，而 -1 返回。

备注

这些功能中的每一个采用指向参数列表，然后使用 _putch 功能格式和编写特定数据绑定到控件中。 (而不是 _putch的_vcwprintf_p 使用 _putwch。 _vcwprintf_p 是 _vcprintf_p的宽字符版本。 它采用宽字符字符串作为参数。)

具有 _l 后缀相同版本的这些功能，但它们使用而不是当前区域设置的区域设置参数。

(如果有) 将每 argument 是输出基于 format相应的格式规范。 格式规范支持位置参数，以便您能够指定参数用于格式字符串的顺序。 有关更多信息，请参见printf_p位置参数。

这些函数不将换行符转换为支持返回换行符 (CR-LF) 组合，因为它们是输出时。

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

这些功能验证输入指针和格式字符串。 如果 format 或 argument 是 NULL，或者，如果格式字符串包含无效格式字符，这些函数调用的参数无效处理程序，如 参数验证所述。 如果执行允许继续，这些函数返回 -1 并将 errno 到 EINVAL。

一般文本例程映射

Tchar.h 实例	未定义的_UNICODE 和_MBCS	定义的_MBCS	定义的_UNICODE
_vtcprintf_p	_vcprintf_p	_vcprintf_p	_vcwprintf_p
_vtcprintf_p_l	_vcprintf_p_l	_vcprintf_p_l	_vcwprintf_p_l

要求

实例	必需的标头
_vcprintf_p, _vcprintf_p_l	<conio.h> 和 <stdarg.h>
_vcwprintf_p, _vcwprintf_p_l	<conio.h> 和 <stdarg.h>

有关更多兼容性信息，请参见 兼容性。

示例

// crt_vcprintf_p.c
// compile with: /c
#include <conio.h>
#include <stdarg.h>

// An error formatting function that's used to print to the console.
int eprintf(const char* format, ...)
{
  va_list args;
  va_start(args, format);
  return _vcprintf_p(format, args);
}

int main()
{
   int n = eprintf("parameter 2 = %2$d; parameter 1 = %1$s\r\n",
      "one", 222);
   _cprintf_s("%d characters printed\r\n");
}

请参见

参考

控制台和端口I/O

_cprintf， _cprintf_l， _cwprintf， _cwprintf_l

va_arg， va_end， va_start

printf_p位置参数