_vcprintf_s、 _vcprintf_s_l、 _vcwprintf_s、 _vcwprintf_s_l

發行項
03/26/2013

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

重要

這個 API 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 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
使用的地區設定。

如需詳細資訊，請參閱格式規格。

傳回值

寫入的字元數或負值，如果發生 I/O 錯誤。

這類函式不安全的版本，否則，如果 format 為 null 指標，無效的參數叫用處理常式，如參數驗證中所述。此外，不同於這些函式不安全的版本，否則，如果 format 沒有指定有效格式，無效的參數會產生例外狀況。如果執行允許繼續執行，這些函式傳回

備註

這些函式都接受指標引數清單，然後格式和寫入至主控台的特定資料。 _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 相容性。

如需其他相容性資訊，請參閱入門介紹中的相容性 (Compatibility) 。

範例

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