_vcprintf_p、 _vcprintf_p_l、 _vcwprintf_p、 _vcwprintf_p_l

寫入格式化輸出到主控台使用指標引數的清單，並支援在格式字串中的位置參數。

重要事項
這個應用程式開發介面無法用來在 Windows 執行階段中執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /ZW。

int _vcprintf_p(
   const char* format,
   va_list argptr
);
int _vcprintf_p_l(
   const char* format,
   locale_t locale,
   va_list argptr
);
int _vcwprintf_p(
   const wchar_t* format,
   va_list argptr
);
int _vcwprintf_p_l(
   const wchar_t* format,
   locale_t locale,
   va_list argptr
);

參數

• format
  格式規格。

• argptr
  引數清單的指標。

• locale
  使用的地區設定。

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

傳回值

要寫入的字元數或負值，如果發生 I/O 錯誤。如果 format 為 null 指標，無效的參數叫用處理常式，如 參數驗證中所述。如果執行允許繼續， errno 設定為 EINVAL ，並傳回 -1。

備註

這些函式都接受指標引數清單，然後使用 _putch 函式給主控台要格式化和寫入特定資料。(而不是 _putch的_vcwprintf_p 使用 _putwch 。_vcwprintf_p 是 _vcprintf_p的寬字元版本。它會採用寬字元字串做為引數)。

具有 _l 尾碼相同版本這些函式，但使用而不是目前地區設定的地區設定參數。

每個 argument (如果有的話) 是根據 format中的對應格式規格轉換和輸出。格式規格支援位置參數，讓您可以指定引數使用格式字串的命令。如需詳細資訊，請參閱printf_p 位置參數。

這些函式不會轉譯換行字元成托架傳回行摘要 (CR-LF) 組合，當輸出時。

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

這些函式會驗證輸入指標和格式字串。如果 format 或 argument 是 NULL，或者，如果格式字串包含無效的格式化字元，這些函式叫用無效的參數處理常式，如 參數驗證中所述。如果執行允許繼續執行，這些函式傳回 -1 並將 errno 設為 EINVAL。

泛用文字常式對應

Tchar.h 常式	未定義的 _UNICODE 和 _MBCS	已定義 _MBCS	已定義 _UNICODE
_vtcprintf_p	_vcprintf_p	_vcprintf_p	_vcwprintf_p
_vtcprintf_p_l	_vcprintf_p_l	_vcprintf_p_l	_vcwprintf_p_l

需求

程序	必要的標頭檔
_vcprintf_p, _vcprintf_p_l	<conio.h> 和 <stdarg.h>
_vcwprintf_p, _vcwprintf_p_l	<conio.h> 和 <stdarg.h>

如需相容性詳細資訊，請參閱 相容性。

範例

// crt_vcprintf_p.c
// compile with: /c
#include <conio.h>
#include <stdarg.h>

// An error formatting function that's used to print to the console.
int eprintf(const char* format, ...)
{
  va_list args;
  va_start(args, format);
  return _vcprintf_p(format, args);
}

int main()
{
   int n = eprintf("parameter 2 = %2$d; parameter 1 = %1$s\r\n",
      "one", 222);
   _cprintf_s("%d characters printed\r\n");
}

請參閱

參考

主控台和連接埠的 I/O

_cprintf、 _cprintf_l、 _cwprintf、 _cwprintf_l

va_arg，va_end va_start

printf_p 位置參數