_vcprintf、_vcprintf_l、_vcwprintf、_vcwprintf_l

發行項
06/09/2015

使用引數清單的指標將格式化輸出寫入至主控台。這些函式已有更安全的版本可用，請參閱 _vcprintf_s、_vcprintf_s_l、_vcwprintf_s、_vcwprintf_s_l。

重要

這個應用程式開發介面不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 /ZW 不支援 CRT 函式。

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 不是使用者定義的字串。如需詳細資訊，請參閱 Avoiding Buffer Overruns 。

一般文字常式對應

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 );
}