_vcprintf_p、_vcprintf_p_l、_vcwprintf_p、_vcwprintf_p_l

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

重要

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

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 函式。

傳回值

寫入的字元數，但當其為負值時，表示輸出發生錯誤。 如果 format 如 參數驗證 中所述為 null 指標，則叫用無效參數處理常式。 如果允許繼續執行， errno 會設為 EINVAL ，並回傳 -1。

備註

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

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

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

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

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

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

一般文字常式對應

Tchar.h 常式	未定義 _UNICODE and _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_copy、va_end、va_start

printf_p 位置參數