printf, _printf_l, wprintf, _wprintf_l

Artykuł
06/09/2015

Drukuje sformatowane dane wyjściowe do strumienia wyjścia standardowego.Bardziej bezpieczne wersje tych funkcji są dostępne w 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
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.Jeśli wskaźnik format ma wartość NULL, zostanie wywołany nieprawidłowy parametr uchwytu wskaźnika, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może być kontynuowane, funkcja zwraca wartość -1 i ustawia errno na EINVAL.Jeśli zostanie napotkane EOF (0xFFFF) w argument, funkcja zwraca wartość -1.

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

Uwagi

Funkcja printf formatuje i drukuje serie znaków i wartości do standardowego strumienia wyjściowego, stdout.Jeśli po ciągu format pojawiają się argumenty, ciąg format musi zawierać specyfikacje, które określają format wyjściowy dla argumentów.printf i fprintf zachowują się identycznie, chyba że printf zapisuje dane wyjściowe do stdout, a nie do miejsca docelowego typu FILE.

wprintf to wersja znaku dwubajtowego printf; format jest ciągiem znaku dwubajtowego.wprintf i printf zachowują się identycznie, jeżeli strumień jest otwarty w trybie ANSI.printf 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	printf	printf	wprintf

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

Rutynowe mapowania zwykłego tekstu

Procedura Tchar.h	_UNICODE i _MBCS nie zdefiniowany	_MBCS zdefiniowano	_UNICODE zdefiniowany
_tprintf	printf	printf	wprintf
_tprintf_l	_printf_l	_printf_l	_wprintf_l

Wymagania

Procedura	Wymagany nagłówek
printf, _printf_l	<stdio.h>
wprintf, _wprintf_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.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);
}

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:   0012FF3C