_vcprintf， _vcprintf_l， _vcwprintf， _vcwprintf_l

项目
04/10/2013

编写格式化输出到控件个使用指针参数列表。这些功能的更安全的版本可用，请参见 _vcprintf_s， _vcprintf_s_l， _vcwprintf_s， _vcwprintf_s_l。

重要

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

int _vcprintf(
   const char* format,
   va_list argptr
);
int _vcprintf_l(
   const char* format,
   locale_t locale,
   va_list argptr
);
int _vcwprintf(
   const wchar_t* format,
   va_list argptr
);
int _vcwprintf_l(
   const wchar_t* format,
   locale_t locale,
   va_list argptr
);

参数

format
格式规范。
argptr
列表的指针参数。
locale
使用的区域设置。

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

返回值

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

备注

这些功能中的每一个采用指向参数列表，然后布局和编写特定数据绑定到控件中。 _vcwprintf 是 _vcprintf的宽字符版本。它采用宽字符字符串作为参数。

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

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

一般文本例程映射

TCHAR.H 实例	未定义的_UNICODE & _MBCS	定义的_MBCS	定义的_UNICODE
_vtcprintf	_vcprintf	_vcprintf	_vcwprintf
_vtcprintf_l	_vcprintf_l	_vcprintf_l	_vcwprintf_l

要求

实例	必需的标头	选项标头
_vcprintf, _vcprintf_l	<conio.h> 和 <stdarg.h>	<varargs.h>*
_vcwprintf, _vcwprintf_l	<conio.h> 或 <wchar.h>和 <stdarg.h>	<varargs.h>*

*仅对 UNIX v 兼容性。

有关其他的兼容性信息，请参见中介绍的兼容性。

示例

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

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

int main()
{
   eprintf("  (%d:%d): Error %s%d : %s\n", 10, 23, "C", 2111,
           "<some error text>");
   eprintf("  (Related to symbol '%s' defined on line %d).\n",
           "<symbol>", 5 );
}