_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l

Makale
06/09/2015

Konsola biçimlendirir ve yazdırır.Bu _cprintf, _cprintf_l, _cwprintf, _cwprintf_l sürümlerinde CRT'deki Güvenlik Özellikleri içinde açıklandığı gibi güvenlik geliştirmeleri mevcut olabilir.

Ö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_s( 
   const char * format [, 
   argument] ... 
);
int _cprintf_s_l( 
   const char * format,
   locale_t locale [, 
   argument] ... 
);
int _cwprintf_s(
   const wchar * format [, 
   argument] ...
);
int _cwprintf_s_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şlevler bir dizi karakter ve değerlerini biçimlendirir ve karakterleri çıkarmak için _putch işlevini kullanarak (_cwprintf_s için _putwch) 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_s işlevi için format parametresi ile aynı form ve işleve sahiptir.fprintf_s, printf_s ve sprintf_s işlevlerinin aksine çıkış yapıldığı sırada _cprintf_s veya _cwprintf_s, satır besleme karakterlerini satır başı besleme (CR-LF) birleşimlerine çevirmez

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

Güvenli olmayan sürümler gibi (bkz: _cprintf, _cprintf_l, _cwprintf, _cwprintf_l), bu işlevler kendi parametrelerini doğrular ve format null işaretçisiyse Parametre Doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisini çağırır.Bu işlevler, güvenli olmayan sürümlerden, biçim dizesinin kendisinin de doğrulanması bakımından farklıdır.Bilinmeyen veya hatalı oluşturulmuş biçimlendirme tanımlayıcıları varsa, bu işlevler geçersiz parametre işleyicisini çağırır.Her durumda yürütmenin devam etmesine izin verilirse 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_s	_cprintf_s	_cprintf_s	_cwprintf_s
_tcprintf_s_l	_cprintf_s_l	_cprintf_s_l	_cwprintf_s_l

Gereksinimler

Yordam	Gerekli başlık
_cprintf_s,_cprintf_s_l	<conio.h>
_cwprintf_s, _cwprintf_s_l	<conio.h>

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

Kitaplıklar

C çalışma zamanı kitaplıklarının çoklu iş parçacığının tüm sürümleri.

Örnek

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