_vcprintf_s、_vcprintf_s_l、_vcwprintf_s、_vcwprintf_s_l

發行項
06/09/2015

使用引數清單的指標將格式化輸出寫入至主控台。這些 _vcprintf、_vcprintf_l、_vcwprintf、_vcwprintf_l 版本有安全性增強功能，如 CRT 中的安全性功能中所述。

重要

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

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
使用的地區設定。

如需詳細資訊，請參閱格式規格語法：printf 和 wprintf 函式。

傳回值

列印的字元數，但當其為負值時，表示輸出發生錯誤。

像是這類函式的較不安全版本，如果 format 為 null 指標，則叫用無效參數處理常式，如參數驗證中所述。此外，不同於這些函式的較不安全版本則為，如果 format 沒有指定有效格式，會產生無效的參數例外狀況。如果執行允許繼續執行，這些函式會傳回錯誤碼並將 errno 設為該錯誤代碼。如果特定值無法適用，其預設錯誤碼為 EINVAL 。

備註

這些函式接受一個指向參數清單的指標，然後格式化並將給定的資料寫入至主控台。 _vcwprintf_s 是 _vcprintf_s的寬字元版本。它會採用寬字元字串做為引數。

這些有 _l 尾碼的函式版本是一樣的，不同之處在於會使用傳入的地區設定，而不使用目前的地區設定。

安全性提示
確認 format 不是使用者定義的字串。如需詳細資訊，請參閱 Avoiding Buffer Overruns 。

一般文字常式對應

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