_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l

Článek
03/26/2013

Formáty a vytiskne do konzoly.Jedná se o verze _cprintf, _cprintf_l, _cwprintf, _cwprintf_l s vylepšení zabezpečení, jak je popsáno v Funkce zabezpečení v CRT.

Důležité
Toto rozhraní API nelze použít v aplikacích, které jsou spuštěny v systému Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /ZW.

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] ...
);

Parametry

format
Řízení formátu řetězce.
argument
Volitelné parametry.
locale
Národní prostředí pro použití.

Vrácená hodnota

Tisknout počet znaků.

Poznámky

Tyto funkce formátování a tisk řady znaků a hodnot přímo ke konzole, použití _putch funkce (_putwch pro _cwprintf_s) pro výstup znaků.Každý argument (je-li k dispozici) je převeden a výstup podle odpovídajícího specifikaci formátu v format.Formát má stejné formuláře a pracovat jako format parametr printf_s funkce.Na rozdíl od fprintf_s, printf_s, a sprintf_s funguje, ani _cprintf_s ani _cwprintf_s převede znaky line feed na return–line přepravu krmiv (CR-LF) kombinace výstupu.

Je důležité rozlišovat, který _cwprintf_s zobrazí znaky Unicode v systému Windows NT.Na rozdíl od _cprintf_s, _cwprintf_s používá aktuální národní prostředí konzoly

Verze těchto funkcí se _l přípony jsou shodné s tím rozdílem, že používají parametr locale předaný namísto aktuální národní prostředí.

Poznámka k zabezpečení
Zajistit, aby format není uživatelem definovaný řetězec.

Podobně jako verze-secure (viz _cprintf, _cprintf_l, _cwprintf, _cwprintf_l), tyto funkce ověření jejich parametrů a vyvolat obslužnou rutinu neplatný parametr, jak je popsáno v Ověření parametrů, pokud format je ukazatel s hodnotou null.Tyto funkce se liší od verze-secure, v tom, že je také ověřeno vlastní řetězec formátu.Splnění všech formátovacích specifikátorů neznámý nebo stoprocentně volat tyto funkce obslužné rutiny neplatný parametr.Ve všech případech, je-li pokračovat, je povoleno zpracování funkce vrátí -1 a errno na EINVAL.

Mapování rutiny obecného textu

Byla zahájena rutina Tchar.h	_UNICODE a _MBCS není definováno	_MBCS, definice	_UNICODE definována
_tcprintf_s	_cprintf_s	_cprintf_s	_cwprintf_s
_tcprintf_s_l	_cprintf_s_l	_cprintf_s_l	_cwprintf_s_l

Požadavky

Byla zahájena rutina	Požadované záhlaví
_cprintf_s,_cprintf_s_l	<conio.h>
_cwprintf_s, _cwprintf_s_l	<conio.h>

Další informace o kompatibilitě v tématu Compatibility v úvodu.

Knihovny

Všechny verze C run-time libraries.

Příklad

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