printf_s, _printf_s_l, wprintf_s, _wprintf_s_l

Artykuł
06/09/2015

Drukuje sformatowane dane wyjściowe do strumienia wyjścia standardowego.Te wersje printf, _printf_l, wprintf, _wprintf_l mają wzmocnienia zabezpieczeń, jak opisano w Funkcje zabezpieczeń w 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
Formant formatu.
argument
Argumenty opcjonalne.
locale
Ustawienia regionalne do użycia.

Wartość zwracana

Zwraca liczbę znaków drukowanych lub wartość ujemną, jeśli wystąpi błąd.

Uwagi

Funkcja printf_s formatuje i drukuje serie znaków i wartości do standardowego strumienia wyjściowego, stdout.Jeśli argumenty po format ciąg, format ciąg musi zawierać specyfikacje, które określają format wyjściowy dla argumentów.

Główną różnicą między printf_s i printf jest to, że printf_s sprawdza ciąg formatu dla prawidłowych znaków formatowania, podczas gdy printf tylko sprawdza, czy ciąg formatu jest pusty wskaźnik.Wyboru albo kończy się niepowodzeniem, jeżeli program obsługi nieprawidłowy parametr jest wywoływany, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może być kontynuowane, funkcja zwraca wartość -1 i ustawia errno na EINVAL.

Aby uzyskać informacje o errno i kodach błędów, zobacz _doserrno, errno, _sys_errlist i _sys_nerr.

printf_si fprintf_s zachowują się identycznie, chyba że printf_s zapisuje dane wyjściowe do stdout , a nie do miejsca docelowego typu FILE.Aby uzyskać więcej informacji, zobacz fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l.

wprintf_s to wersja znaku dwubajtowego printf_s; format jest ciągiem znaku dwubajtowego.wprintf_s i printf_s zachowują się identycznie, jeżeli strumień jest otwarty w trybie ANSI.printf_s aktualnie nie obsługuje danych wyjściowych w strumieniu UNICODE.

Wersje tych funkcji z przyrostkiem _l są identyczne z wyjątkiem stosowania regionalnych parametrów zamiast bieżącego ciągu.

Rutynowe mapowania zwykłego tekstu

Procedura Tchar.h	_UNICODE & _MBCS nie zdefiniowano	_MBCS zdefiniowano	_unicode zdefiniowany
_tprintf_s	printf_s	printf_s	wprintf_s
_tprintf_s_l	_printf_s_l	_printf_s_l	_wprintf_s_l

Argument format składa się ze zwykłych znaków, sekwencji pominięcia oraz (jeśli dalej występują argumenty) ze specyfikacji formatu format).Znaki zwykłe i sekwencje wyjścia są kopiowane do stdout w kolejności, w której się pojawiają.Na przykład wiersz

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

generuje dane wyjściowe

Line one
        Line two

Specyfikacje formatu zawsze zaczynają się od znaku procenta (%) i są odczytywane od lewej do prawej.Kiedy printf_s napotka pierwszą specyfikację formatu (jeżeli taka istnieje), konwertuje wartość pierwszego argumentu po format i odpowiednio je wysyła.Druga specyfikacja formatu powoduje konwersję drugiego argumentu i wydalenie na zewnątrz, i tak dalej.Jeśli istnieje więcej argumentów niż specyfikacji formatu, dodatkowe argumenty są ignorowane.Wyniki są niezdefiniowane, jeżeli nie ma wystarczającej liczby argumentów dla wszystkich specyfikacji formatu.

Uwaga dotycząca zabezpieczeń
Zapewnienia, że format nie jest ciągiem zdefiniowanym przez użytkownika.

Wymagania

Procedura	Wymagany nagłówek
printf_s, _printf_s_l	<stdio.h>
wprintf_s, _wprintf_s_l	<stdio.h> lub <wchar.h>

Konsola nie jest obsługiwana w aplikacjach Windows Store.Standardowe uchwyty strumienia powiązane z konsolą—stdin, stdout, i stderr—muszą zostać przekierowane zanim będą wykorzystane przez funkcje środowiska uruchomieniowego C w aplikacjach Windows Store.Dodatkowe informacje o zgodności – zobacz: Zgodność.

Przykład

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

}

Przykładowe dane wyjściowe

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