_printf_p、 _printf_p_l、 _wprintf_p、 _wprintf_p_l

發行項
03/27/2013

列印至標準輸出資料流中輸出，且能夠指定參數用於格式字串的命令。

int _printf_p(
   const char *format [,
   argument]... 
);
int _printf_p_l(
   const char *format,
   locale_t locale [,
   argument]... 
);
int _wprintf_p(
   const wchar_t *format [,
   argument]... 
);
int _wprintf_p_l(
   const wchar_t *format,
   locale_t locale [,
   argument]... 
);

參數

format
格式控制。
argument
選擇性參數。
locale
使用的地區設定。

傳回值

如果發生錯誤，則傳回字元的列印或負數值數目。

備註

_printf_p函式格式化並列印一系列的字元，並且對應至標準輸出資料流的值，則為 stdout。如果引數後面接著 format 字串， format 字串必須包含判斷引數的輸出格式的規格 (請參閱 printf_p 位置參數)。

在 _printf_p和 printf_s的差異在於 _printf_p支援位置參數，可以指定命令引數使用格式字串。如需詳細資訊，請參閱printf_p 位置參數。

_wprintf_p 是 _printf_p的寬字元版本;資料流，則在 ANSI 模式中，開啟它們的作用完全相同。_printf_p 目前不支援輸出到 UNICODE 串流。

這些函式的以 _l 後綴版本相同，但使用傳遞的地區設定參數而非目前執行緒的地區設定。

安全性提示
須確保 format 不是使用者定義的字串。

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

泛用文字常式對應

Tchar.h 常式	未定義的 _UNICODE 和 _MBCS	已定義 _MBCS	已定義 _UNICODE
_tprintf_p	_printf_p	_printf_p	_wprintf_p
_tprintf_p_l	_printf_p_l	_printf_p_l	_wprintf_p_l

需求

程序	必要的標頭檔
_printf_p, _printf_p_l	<stdio.h>
_wprintf_p, _wprintf_p_l	<stdio.h> 或 <wchar.h>

主控台 Windows 市集應用程式不支援。標準資料流控制代碼與主控台， stdin， stdout和 stderr，在這種情況下， C 執行階段函式在 Windows 市集應用程式之前，可以使用它們必須重新導向。如需更多關於相容性的資訊，請參閱入門介紹中的相容性 (Compatibility) 。

範例

// crt_printf_p.c
// This program uses the _printf_p and _wprintf_p
// functions to choose the order in which parameters
// are used.

#include <stdio.h>

int main( void )
{
   // Positional arguments 
   _printf_p( "Specifying the order: %2$s %3$s %1$s %4$s %5$s.\n",
              "little", "I'm", "a", "tea", "pot");

   // Resume arguments
   _wprintf_p( L"Reusing arguments: %1$d %1$d %1$d %1$d\n", 10);

   // Width argument
   _printf_p("Width specifiers: %1$*2$s", "Hello\n", 10);
}