_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l

Makale
03/26/2013

Biçimleri ve konsola yazdırır.Sürümleri bunlar _cprintf, _cprintf_l, _cwprintf, _cwprintf_l açıklandığı gibi güvenlik geliştirmeleri ile crt güvenlik özellikleri.

Ö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_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
Denetimi Biçimlendir dize.
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 biçimlendirmek ve bir dizi karakter ve değerlerini konsola doğrudan yazdırma kullanarak _putch işlev (_putwch için _cwprintf_s) çı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_s işlev.Aksine fprintf_s, printf_s, ve sprintf_s işlev, her ikisi de _cprintf_s , ne de _cwprintf_s satır besleme karakterleri satır başı return–line Besleme (cr-lf) birleşimleri çevirir çıkış.

Önemli bir ayrım olan _cwprintf_s Windows NT kullanılan Unicode karakterlerini görüntüler.Aksine _cprintf_s, _cwprintf_s geçerli konsol yerel ayarı 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.

Güvenli olmayan sürümleri gibi (bkz: _cprintf, _cprintf_l, _cwprintf, _cwprintf_l), bu işlevler parametrelerini doğrulamak ve açıklandığı gibi geçersiz bir parametre işleyicisi çağırmak Parametre doğrulama, format null bir işaretçidir.Bu işlevler güvenli olmayan sürümlerinden farklı biçim dizesi de doğrulanır.Bilinmeyen veya hatalı oluşturulmuş herhangi bir biçimlendirme belirticileri varsa, bu işlevleri geçersiz parametre işleyicisini çağırabilir.Yürütülmesine devam etmek için izin verilip verilmediğini her durumda, -1 işlevler dönmek 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_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 uyumluluk bilgileri için bkz: Uyumluluk giriş.

Kitaplıkları

Tüm sürümleri c çalışma zamanı kitaplıkları.

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