_printf_p、_printf_p_l、_wprintf_p、_wprintf_p_l

發行項
07/29/2015

列印輸出至標準輸出資料流中，並啟用參數用於格式字串命令的規格。

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 and _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 市集應用程式中使用它們。如需相容性的詳細資訊，請參閱相容性。

範例

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