_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Makale
06/09/2015

Konsola biçimlendirir ve yazdırır.Daha güvenli bir sürüm vardır; bkz: _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l.

Ö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( 
   const char * format [, 
   argument] ... 
);
int _cprintf_l( 
   const char * format,
   locale_t locale [,
   argument] … 
);
int _cwprintf(
   const wchar * format [, 
   argument] …
);
int _cwprintf_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

Yazdırılan karakter sayısı.

Notlar

Bu işlevleri, bir dizi karakter ve değerlerini biçimlendirir ve karakterleri çıkarmak için _putch işlevini (_cwprintf için _putwch) 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 işlevi için format parametresi ile aynı form ve işleve sahiptir.fprintf, printf ve sprintf işlevlerinin aksine çıkış yapıldığı sırada _cprintf veya _cwprintf, satır besleme karakterlerini satır başı besleme (CR-LF) birleşimlerine çevirmez

Önemli bir ayrıntı da _cwprintf öğesinin Windows NT'de kullanıldığı zaman Unicode karakterleri görüntülemesidir._cprintf, _cwprintf öğesinden farklı olarak 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.

_cprintfformat parametresini doğrular.format bir null işaretçisiyse, işlev geçersiz parametre işleyicisini Parametre Doğrulama bölümünde açıklandığı gibi çağırır.Yürütmenin devam etmesine izin verilirse işlev -1 döndürür ve errno öğesini EINVAL olarak ayarlar.

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

Genel Metin Yordam Eşleşmeleri

Tchar.h yordamı	_UNICODE ve _MBCS tanımlanmaz	_MBCS tanımlanmış	_UNICODE tanımlanmış
_tcprintf	_cprintf	_cprintf	_cwprintf
_tcprintf_l	_cprintf_l	_cprintf_l	_cwprintf_l

Gereksinimler

Yordam	Gerekli başlık
_cprintf,_cprintf_l	<conio.h>
_cwprintf, _cwprintf_l	<conio.h>

Daha fazla ek uyumluluk bilgileri için bkz. Uyumluluk.

Örnek

// crt_cprintf.c
// compile with: /c
// This program displays some variables to the console.

#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( "%d  %.4x  %u  %c %s\r\n", i, h, u, c, s );
}