_vcprintf_s， _vcprintf_s_l， _vcwprintf_s， _vcwprintf_s_l

项目
04/10/2013

编写格式化输出到控件个使用指针参数列表。这些是 _vcprintf， _vcprintf_l， _vcwprintf， _vcwprintf_l 的版本与安全增强如 CRT中的安全功能所述。

重要

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

int _vcprintf(
   const char* format,
   va_list argptr
);
int _vcprintf(
   const char* format,
   locale_t locale,
   va_list argptr
);
int _vcwprintf_s(
   const wchar_t* format,
   va_list argptr
);
int _vcwprintf_s_l(
   const wchar_t* format,
   locale_t locale,
   va_list argptr
);

参数

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

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

返回值

编写的字符数或负值，如果输出错误。

与这些功能的不安全的版本，因此，如果 format 是 null 指针，无效参数调用处理程序，如参数验证所述。此外，与这些功能的不安全的版本，因此，如果 format 不指定有效格式，无效参数将引发异常。如果执行允许继续，这些函数返回

备注

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

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

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

一般文本例程映射

TCHAR.H 实例	未定义的_UNICODE & _MBCS	定义的_MBCS	定义的_UNICODE
_vtcprintf_s	_vcprintf_s	_vcprintf_s	_vcwprintf_s
_vtcprintf_s_l	_vcprintf_s_l	_vcprintf_s_l	_vcwprintf_s_l

要求

实例	必需的标头	选项标头
_vcprintf_s, _vcprintf_s_l	<conio.h> 和 <stdarg.h>	<varargs.h>*
_vcwprintf_s, _vcwprintf_s_l	<conio.h> 或 <wchar.h>和 <stdarg.h>	<varargs.h>*

*仅对 UNIX v 兼容性。

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

示例

// crt_vcprintf_s.cpp
#include <conio.h>
#include <stdarg.h>

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

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