_vcprintf_p、_vcprintf_p_l、_vcwprintf_p、_vcwprintf_p_l

通过使用指向参数列表的指针，将编写格式输出到控制台，并支持格式字符串的位置参数。

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 是空指针，则会调用无效参数处理程序，如 参数验证 所述。 如果允许继续执行，将 EINVAL 设置为 errno，并返回 -1。

备注

这些函数需要指向参数列表的指针，然后使用 _putch 函数格式化和写入特定数据到控制台。(_vcwprintf_p 使用 _putwch 而不是 _putch。 _vcwprintf_p 是 _vcprintf_p的宽字符版本。 它采用宽字符字符串作为参数。)

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

每个 argument（如果有）根据 format 中相应的格式规范进行转换和输出。 格式规范支持位置参数，以便您可以指定参数在格式字符串中使用的顺序。 有关详细信息，请参阅printf_p 位置参数。

当输出时，这些函数不将换行字符转化成回车换行字符（CR-LF）组合。

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

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

一般文本例程映射

要求

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

示例

// 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_copy、va_end、va_start

printf_p 位置参数