_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l

Makale
07/29/2015

Standart çıkış akışına biçimlendirilmiş çıkışı yazdırır ve biçim dizesinde kullanılan parametrelerin sırasını belirtmeye olanak tanır.

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]... 
);

Parametreler

format
Biçim denetimi.
argument
İsteğe bağlı bağımsız değişkenler.
locale
Kullanılacak yerel ayar.

Dönüş Değeri

Bir hata oluşursa yazdırılan karakter sayısını veya negatif bir değer döndürür.

Notlar

_printf_p işlevi, stdout standart çıktı akışı için bir dizi karakter ve değer biçimlendirir ve yazdırır.Bağımsız değişkenler format dizesini izliyorsa, format dizesi bağımsız değişkenler için çıkış biçimini belirleyen belirtimler içermelidir (bkz. printf_p Konumsal Parametreler).

_printf_p ve printf_s arasındaki fark, _printf_p işlevinin, bağımsız değişkenlerin biçim dizesindeki sırasını belirtmeye izin veren konum parametrelerini desteklemesidir.Daha fazla bilgi için bkz. printf_p Konumsal Parametreler.

_wprintf_p_printf_p öğesinin geniş karakterli sürümüdür; akış ANSI modunda açılırsa, aynı şekilde davranırlar._printf_p şu anda UNICODE akışına çıkış alınmasını desteklemez.

_l sonekine sahip bu işlevlerin sürümleri, geçerli iş parçacığı yerel ayarı yerine iletilen yerel ayar parametresini kullanmalarıdır.

Güvenlik Notu
format öğesinin bir kullanıcı tanımlı dize olmadığından emin olun.

format ve argumentNULL ise veya biçim dizesi geçersiz biçim karakterleri içeriyorsa, _printf_p ve _wprintf_p işlevleri Parametre Doğrulama konusunda açıklanan şekilde geçersiz bir parametre işleyici çağırır.Yürütmenin devam etmesine izin verilirse işlev -1 döndürür ve errno öğesini EINVAL olarak ayarlar.

Genel Metin Yordam Eşleşmeleri

Tchar.h yordamı	_UNICODE ve _MBCS tanımlanmaz	_MBCS tanımlanmış	_UNICODE tanımlanmış
_tprintf_p	_printf_p	_printf_p	_wprintf_p
_tprintf_p_l	_printf_p_l	_printf_p_l	_wprintf_p_l

Gereksinimler

Yordam	Gerekli başlık
_printf_p, _printf_p_l	<stdio.h>
_wprintf_p, _wprintf_p_l	<stdio.h> or <wchar.h>

Konsol Windows Mağazası uygulamalarında desteklenmiyor.stdin, stdout ve stderr konsolları ile ilişkili standart akış işleyicileri, C çalışma zamanı işlevleri bunları Windows Mağazası uygulamalarında kullanmadan önce yeniden yönlendirilmelidir.Daha fazla ek uyumluluk bilgileri için bkz. Uyumluluk.

Örnek

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