_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l

Makale
03/15/2013

Biçimleri ve dize biçiminde Konumsal parametreler için destek Konsolu yazdırır.

Önemli
Bu API, Windows çalışma zamanı yürütme uygulamalarda kullanılamaz.Daha fazla bilgi için bkz: /zw ile desteklenmeyen crt işlevlerinin.

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
Denetimi Biçimlendir dize.
argument
İsteğe bağlı parametreler.
locale
Kullanılacak yerel ayarı.

Dönüş Değeri

Yazdırılan karakterler veya bir hata oluşursa, negatif bir değer sayısı.

Notlar

Bu işlevler biçimlendirmek ve bir dizi karakter ve değerlerini konsola doğrudan yazdırma kullanarak _putch ve _putwch işlevleri için çıkış karakteri.Her argument (varsa) dönüştürülür ve çıktı içinde karşılık gelen biçim belirtimi göre format.Form ve işlev olarak aynı biçime sahip format parametresi için printf_p işlev.Arasındaki fark _cprintf_p ve cprintf_s olan _cprintf_p Biçim dizesinde bağımsız değişkenler kullanılır sırasını belirleme sağlar destekler Konumsal parametreler.Daha fazla bilgi için bkz. printf_p Konumsal Parametreler.

Aksine fprintf_p, printf_p, ve sprintf_p işlev, her ikisi de _cprintf_p , ne de _cwprintf_p satır besleme karakterleri satır başı return–line Besleme (cr-lf) birleşimleri çevirir çıkış.Önemli bir ayrım olan _cwprintf_p Windows NT kullanılan Unicode karakterlerini görüntüler.Aksine _cprintf_p, _cwprintf_p geçerli konsol yerel ayarları kullanır.

Bu işlevleri sürümlerini _l sonek dışında geçerli yerel ayarı geçirilen yerel ayar parametresi kullandıkları aynı.

Güvenlik Notu
Emin format kullanıcı tanımlı bir dize değil.

Ayrıca, ister _cprintf_s ve _cwprintf_s, bunlar giriş işaretçisi ve biçim dizesi doğrular.format Veya argument olan NULL, ya da biçimi geçersiz biçimlendirme karakteri dize içerir, açıklandığı gibi bu işlevleri geçersiz parametre işleyicisi çağırmak Parametre doğrulama.Yürütülmesine devam etmek için izin verilirse, bu işlevler -1 döndürür ve errno için EINVAL.

Genel metin eşlemeleri yordamına girildi

Tchar.h yordamına girildi	_UNICODE ve _mbcs tanımlanmamış	Tanımlanan _mbcs	Tanımlanan _UNICODE
_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>

Daha fazla uyumluluk bilgileri için bkz: Uyumluluk giriş.

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