printf_s, _printf_s_l, wprintf_s, _wprintf_s_l

Artykuł
03/26/2013

Drukowanie sformatowane wyniki do strumienia wyjścia standardowego.Są to wersje printf, _printf_l, wprintf, _wprintf_l z ulepszeń zabezpieczeń, zgodnie z opisem 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
Formatuj formant.
argument
Argumentów opcjonalnych.
locale
Ustawienia regionalne używane.

Wartość zwracana

Zwraca liczbę znaków drukowanych lub wartość ujemną, w przypadku wystąpienia błędu.

Uwagi

printf_s Funkcja formatuje i wyświetla szereg znaków i wartości, które mają Standardowy strumień wyjściowy, stdout.Jeśli argumenty postępuj zgodnie z format string, format ciąg musi zawierać specyfikacje, które określają format danych wyjściowych dla argumentów.

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

Aby uzyskać informacje o errno i kody 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_sjest ona szerokich znaków do printf_s; formatjest łańcuch szerokich znaków.wprintf_si printf_s zachowują się identycznie, jeśli strumień jest otwarty w trybie ANSI.printf_saktualnie nie obsługuje dane wyjściowe do strumienia UNICODE.

Wersje te funkcje za pomocą _l sufiks są identyczne z tym, że używają przekazany zamiast bieżących ustawień regionalnych wątek parametr ustawień regionalnych.

Tekst rodzajowy rutynowych mapowania

TCHAR.Rozpoczęto wykonywanie procedury h	_UNICODE & _MBCS nie zdefiniowany	_MBCS, definicja	_UNICODE, definicja
_tprintf_s	printf_s	printf_s	wprintf_s
_tprintf_s_l	_printf_s_l	_printf_s_l	_wprintf_s_l

format Argument, który składa się ze znaków zwykłych, sekwencje escape i (Jeśli argumenty postępuj zgodnie z format) format specyfikacji.Znaków zwykłych i sekwencje unikowe są kopiowane do stdout w kolejności ich występowania.Na przykład wiersz

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

generuje dane wyjściowe

Line one
        Line two

Sformatować specyfikacje zawsze zaczynają się znakiem procentu (%) i są odczytywane od lewej do prawej.Po printf_s napotka pierwszej specyfikacji formatu (jeśli istnieje), konwertuje wartość pierwszego argumentu po format i umieszcza go odpowiednio.Drugi specyfikacja formatu powoduje, że drugi argument może być konwertowane i produkcji, i tak dalej.W przypadku liczbą argumentów większą niż istnieją format specyfikacje, dodatkowe argumenty są ignorowane.Wyniki będą niezdefiniowane, jeśli nie ma za mało argumentów dla wszystkich specyfikacji formatu.

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

Wymagania

Rozpoczęto wykonywanie procedury	Wymaganego nagłówka
printf_s, _printf_s_l	<stdio.h>
wprintf_s, _wprintf_s_l	<stdio.h> lub <wchar.h>

Konsola nie jest obsługiwana w Windows Store aplikacji.Związanych z konsolą, dojścia do strumienia standard stdin, stdout, i stderr, muszą być przeniesione, aby funkcje uruchomieniowej C mogą być użyte w Windows Store aplikacji.Aby uzyskać dodatkowe informacje o zgodności, zobacz zgodności we wprowadzeniu.

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