_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l

Makale
06/09/2015

Konsola biçimlendirir ve yazdırılır ve biçim dizesindeki konum parametrelerini destekler.

Önemli
Bu API, Windows Çalışma Zamanı'nda yürütülen uygulamalarda kullanılamaz.Daha fazla bilgi için bkz /ZW ile desteklenmeyen CRT işlevleri.

int _cprintf_p( 
   const char * format [, 
   argument] ... 
);
int _cprintf_p_l( 
   const char * format,
   locale_t locale [, 
   argument] ... 
);
int _cwprintf_p(
   const wchar * format [, 
   argument] ...
);
int _cwprintf_p_l(
   const wchar * format,
   locale_t locale [,
   argument] ...
);

Parametreler

format
Biçim denetimi dizesi.
argument
İsteğe bağlı parametreler.
locale
Kullanılacak yerel ayar.

Dönüş Değeri

Bir hata oluşması durumunda, yazdırılan karakter veya negatif değer sayısı.

Notlar

Bu işlevler, bir dizi karakter ve değerlerini biçimlendirir ve karakterleri çıkarmak için _putch ve _putwch işlevlerini kullanarak doğrudan konsola yazdırır.Her argument (varsa) dönüştürülür ve denk gelen format kapsamındaki biçim belirtimine göre çıkışı alınır.Format printf_p işlevi için format parametresi ile aynı form ve işleve sahiptir._cprintf_p ve cprintf_s arasındaki fark, _cprintf_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.

fprintf_p, printf_p ve sprintf_p işlevlerinin aksine çıkış yapıldığı sırada _cprintf_p veya _cwprintf_p, satır besleme karakterlerini satır başı besleme (CR-LF) birleşimlerine çevirmezÖnemli bir ayrıntı da _cwprintf_p öğesinin Windows NT'de kullanıldığı zaman Unicode karakterleri görüntülemesidir._cprintf_p öğesinden farklı olarak _cwprintf_p geçerli konsol yerel ayarlarını kullanır.

_l sonekine sahip bu işlevlerin sürümleri, geçerli 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.

Ayrıca, _cprintf_s ve _cwprintf_s gibi, giriş işaretleyicisini ve biçim dizesini doğrularlar.format veya argument ise NULL ya da format dizesi geçersiz biçim karakterleri içeriyorsa, bu işlevler geçersiz parametre işleyicisini Parametre Doğrulama içinde açıklanan şekilde çağırır.Yürütmenin devam etmesine izin verilirse, bu işlevler -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ış
_tcprintf_p	_cprintf_p	_cprintf_p	_cwprintf_p
_tcprintf_p_l	_cprintf_p_l	_cprintf_p_l	_cwprintf_p_l

Gereksinimler

Yordam	Gerekli başlık
_cprintf_p,_cprintf_p_l	<conio.h>
_cwprintf_p,_cwprintf_p_l	<conio.h>

Uyumluluk hakkında daha fazla bilgi için bkz. Uyumluluk.

Örnek

// crt_cprintf_p.c
// This program displays some variables to the console
// using the _cprintf_p function.

#include <conio.h>

int main( void )
{
    int         i = -16,
                h = 29;
    unsigned    u = 62511;
    char        c = 'A';
    char        s[] = "Test";

    // Note that console output does not translate
    // \n as standard output does. Use \r\n instead.
    _cprintf_p( "%2$d  %1$.4x  %3$u  %4$c %5$s\r\n", 
                h, i, u, c, s );
}