_vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l

编写格式化输出到控件个使用指针参数列表。 这些功能的更安全的版本可用,请参见 _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 );
}
  

.NET Framework 等效项

System::Console::Write

请参见

参考

流I/O

vprintf功能

_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

fprintf, _fprintf_l, fwprintf, _fwprintf_l

printf, _printf_l, wprintf, _wprintf_l

sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l

va_arg, va_end, va_start