printf_s, _printf_s_l, wprintf_s, _wprintf_s_l

Článek
06/09/2015

Tiskne formátovaný výstup v standardním výstupním datovém proudu.Tyto verze printf, _printf_l, wprintf, _wprintf_l mají rozšíření zabezpečení popsaná v tématu Funkce zabezpečení v CRT.

int printf_s(
   const char *format [,
   argument]... 
);
int _printf_s_l(
   const char *format,
   locale_t locale [,
   argument]... 
);
int wprintf_s(
   const wchar_t *format [,
   argument]... 
);
int _wprintf_s_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.

Poznámky

Funkce printf_s formátuje a vytiskne řadu znaků a hodnoty do standardního výstupního proudu stdout.Pokud argumenty Formát řetězce, format řetězec musí obsahovat specifikace, které určuje požadovaný výstupní formát argumentů.

Hlavní rozdíl mezi printf_s a printf je printf_s kontroluje formát řetězce pro platný formátování znaků, že printf pouze zkontroluje, zda formátovací řetězec je nulový ukazatel.Pokud buď kontrola nezdaří, vyvolán obslužnou rutinu neplatný parametr, 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.

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

printf_sa fprintf_s chovaly stejně jako s výjimkou printf_s zapíše výstup do stdout , nikoli k určení typu FILE.Další informace naleznete v tématu fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l.

wprintf_s je širokoznaková verze printf_s; format je širokoznakový řetězec.wprintf_s a printf_s se chovají stejně jako v případě, že datový proud je otevřen v režimu ANSI.printf_s 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_s	printf_s	printf_s	wprintf_s
_tprintf_s_l	_printf_s_l	_printf_s_l	_wprintf_s_l

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_s("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_s 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.

Požadavky

Rutina	Požadované záhlaví
printf_s, _printf_s_l	<stdio.h>
wprintf_s, _wprintf_s_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_s.c
/* This program uses the printf_s and wprintf_s functions
 * to produce formatted output.
 */

#include <stdio.h>

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

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

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

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

   /* Display characters. */

   printf_s("Characters in field (1):\n%10c%5hc%5C%5lc\n", ch, ch, wch, wch);
   wprintf_s(L"Characters in field (2):\n%10C%5hc%5c%5lc\n", ch, ch, wch, wch);

   /* Display strings. */

   printf_s("Strings in field (1):\n%25s\n%25.4hs\n   %S%25.3ls\n",
   string, string, wstring, wstring);
   wprintf_s(L"Strings in field (2):\n%25S\n%25.4hs\n   %s%25.3ls\n",
       string, string, wstring, wstring);

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

   /* Display pointer. */
   printf_s( "\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:   0012FF78