printf, _printf_l, wprintf, _wprintf_l

Článek
06/09/2015

Tiskne formátovaný výstup v standardním výstupním datovém proudu.Bezpečnější verze těchto funkcí jsou k dispozici; viz printf_s, _printf_s_l, wprintf_s, _wprintf_s_l.

int printf(
   const char *format [,
   argument]... 
);
int _printf_l(
   const char *format,
   locale_t locale [,
   argument]... 
);
int wprintf(
   const wchar_t *format [,
   argument]... 
);
int _wprintf_l(
   const wchar_t *format,
   locale_t locale [,
   argument]... 
);

Parametry

format
Ovládání formátu.
argument
Volitelné argumenty.
locale
Použité národní prostředí.

Vrácená hodnota

Vrátí počet vytištěných znaků nebo v případě chyby zápornou hodnotu.Pokud format je NULL, je vyvolána obslužná rutina neplatného parametru, jak je popsáno v Ověření parametru.Pokud provádění může pokračovat, funkce vrátí hodnotu -1 a nastaví errno na EINVAL.Pokud EOF (0xFFFF) je zaznamenáno v argument, funkce vrátí -1.

Informace o errno a chybové kódy naleznete v části _doserrno, errno, _sys_errlist a _sys_nerr.

Poznámky

Funkce printf formátuje a vytiskne řadu znaků a hodnoty do standardního výstupního proudu stdout.Pokud argumenty jsou podle řetězce format, řetězec format musí obsahovat specifikace, které určují požadovaný výstupní formát argumentů.printf a fprintf se chovají stejně, až na výjimku, že printf zapíše výstup do stdout, nikoli do umístění typu FILE.

wprintf je širokoznaková verze printf; format je širokoznakový řetězec.wprintf a printf se chovají stejně jako v případě, že datový proud je otevřen v režimu ANSI.printf aktuálně nepodporuje výstup v proudu UNICODE.

Verze těchto funkcí s příponou _l jsou stejné s tím rozdílem, že používají parametr předané národní prostředí namísto aktuálního národní prostředí pro vlákno.

Rutinní mapování obecného textu

Rutina TCHAR.H	_UNICODE & _MBCS není definováno	_MBCS definováno	_unicode definováno
_tprintf	printf	printf	wprintf

Argument format se skládá z běžných znaků, řídících sekvencí a specializace formátu (pokud argumenty následují po parametru format).Běžné znaky a sekvence escape se zkopírují do stdout v pořadí jejich výskytu.Například řádek:

printf("Line one\n\t\tLine two\n");

vytvoří výstup:

Line one
        Line two

Specifikace formátu vždy začínají znakem procenta (%) a jsou čteny zleva doprava.Když printf nalezne první specifikaci formátu (pokud existuje), převede hodnotu prvního argumentu po format a uloží jej odpovídajícím způsobem.Druhá specifikace formátu způsobí, že druhý argument bude převeden a uložen, atp.Pokud existuje více argumentů, než je specifikace formátu, další argumenty jsou ignorovány.Výsledky nejsou definovány, jestliže neexistuje dostatek argumentů pro všechny specifikace formátu.

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

Rutinní mapování obecného textu

Rutina Tchar.h	_UNICODE a _MBCS nejsou definovány	_MBCS definováno	_UNICODE definováno
_tprintf	printf	printf	wprintf
_tprintf_l	_printf_l	_printf_l	_wprintf_l

Požadavky

Rutina	Požadované záhlaví
printf, _printf_l	<stdio.h>
wprintf, _wprintf_l	<stdio.h> nebo <wchar.h>

Konzola není v aplikacích Windows Store podporována.Standardní datový proud popisovačů, které jsou spojeny s konzolou – stdin, stdout a stderr, musí být přesměrován před použitím funkcí jazyka C run-time je v aplikacích Windows Store.Další informace o kompatibilitě naleznete v tématu Kompatibilita.

Příklad

// crt_printf.c
// This program uses the printf and wprintf functions
// to produce formatted output.

#include <stdio.h>

int main( void )
{
   char     ch = 'h', 
            *string = "computer";
   wchar_t  wch = L'w', 
            *wstring = L"Unicode";
   int      count = -9234;
   double   fp = 251.7366;

   // Display integers
   printf( "Integer formats:\n"
           "   Decimal: %d  Justified: %.6d  "
           "Unsigned: %u\n",
           count, count, count, count );

   // Display decimals
   printf( "Decimal %d as:\n   Hex: %Xh  "
           "C hex: 0x%x  Octal: %o\n",
            count, count, count, count );

   // Display in different radixes
   printf( "Digits 10 equal:\n   Hex: %i  "
           "Octal: %i  Decimal: %i\n",
            0x10, 010, 10 );

   // Display characters
   printf("Characters in field (1):\n"
          "%10c%5hc%5C%5lc\n",
          ch, ch, wch, wch);
   wprintf(L"Characters in field (2):\n"
           L"%10C%5hc%5c%5lc\n",
           ch, ch, wch, wch);

   // Display strings
   printf("Strings in field (1):\n%25s\n"
          "%25.4hs\n   %S%25.3ls\n",
          string, string, wstring, wstring);
   wprintf(L"Strings in field (2):\n%25S\n"
           L"%25.4hs\n   %s%25.3ls\n",
           string, string, wstring, wstring);

   // Display real numbers
   printf("Real numbers:\n   %f %.2f %e %E\n",
          fp, fp, fp, fp );

   // Display pointer
   printf( "\nAddress as:   %p\n", &count);
}

Výstup ukázky

Integer formats:
   Decimal: -9234  Justified: -009234  Unsigned: 4294958062
Decimal -9234 as:
   Hex: FFFFDBEEh  C hex: 0xffffdbee  Octal: 37777755756
Digits 10 equal:
   Hex: 16  Octal: 8  Decimal: 10
Characters in field (1):
         h    h    w    w
Characters in field (2):
         h    h    w    w
Strings in field (1):
                 computer
                     comp
   Unicode                      Uni
Strings in field (2):
                 computer
                     comp
   Unicode                      Uni
Real numbers:
   251.736600 251.74 2.517366e+002 2.517366E+002

Address as:   0012FF3C