_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Článek
03/26/2013

Formáty a vytiskne do konzoly.Bezpečnější verze jsou k dispozici; see _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l.

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( 
   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] …
);

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

Tytofunkce formátování a tisk řady znaků a hodnot přímo ke konzole, použití _putch funkce (_putwch pro _cwprintf) 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 funkce.Na rozdíl od fprintf, printf, a sprintf funguje, ani _cprintf ani _cwprintf převede znaky line feed na return–line přepravu krmiv (CR-LF) kombinace výstupu.

Je důležité rozlišovat, který _cwprintf zobrazí znaky Unicode v systému Windows NT.Na rozdíl od _cprintf, _cwprintf používá aktuální nastavení národního 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í.

_cprintfověřuje format parametr.Pokud format je nulový ukazatel funkce vyvolá obslužnou rutinu neplatný parametr, jak je popsáno v Ověření parametrů.Je-li pokračovat, funkce vrátí hodnotu -1 a sady je povoleno zpracování errno na EINVAL.

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

Mapování rutiny obecného textu

Byla zahájena rutina Tchar.h	_UNICODE a _MBCS není definováno	_MBCS, definice	_UNICODE definována
_tcprintf	_cprintf	_cprintf	_cwprintf
_tcprintf_l	_cprintf_l	_cprintf_l	_cwprintf_l

Požadavky

Byla zahájena rutina	Požadované záhlaví
_cprintf,_cprintf_l	<conio.h>
_cwprintf, _cwprintf_l	<conio.h>

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

Příklad

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