Udostępnij za pośrednictwem

fprintf, , _fprintf_l, fwprintf, _fwprintf_l, , _ftprintf_ftprintf_l

  • Artykuł

Drukuj sformatowane dane do strumienia. Dostępne są bezpieczniejsze wersje tych funkcji; zobacz fprintf_s, , fwprintf_s_fprintf_s_l, , _fwprintf_s_l.

Aby zapoznać _ftprintf się z tematem i _ftprintf_l, zobacz Ogólne mapowania funkcji tekstowych.

Składnia

int fprintf(
   FILE *stream,
   const char *format [,
   argument ]...
);
int _fprintf_l(
   FILE *stream,
   const char *format,
   _locale_t locale [,
   argument ]...
);
int fwprintf(
   FILE *stream,
   const wchar_t *format [,
   argument ]...
);
int _fwprintf_l(
   FILE *stream,
   const wchar_t *format,
   _locale_t locale [,
   argument ]...
);

Parametry

stream
Wskaźnik do FILE struktury.

format
Ciąg kontroli formatu.

argument
Argumenty opcjonalne.

locale
Ustawienia regionalne do użycia.

Wartość zwracana

fprintf zwraca liczbę zapisanych bajtów. fwprintf Zwraca liczbę zapisanych znaków szerokich. Każda z tych funkcji zwraca wartość ujemną zamiast tego, gdy wystąpi błąd wyjściowy. Jeśli stream lub format ma NULLwartość , te funkcje wywołują nieprawidłową procedurę obsługi parametrów zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonywanie jest dozwolone do kontynuowania, funkcje zwracają wartość -1 i ustawiają wartość errno EINVAL. Ciąg formatu nie jest sprawdzany pod kątem prawidłowych znaków formatowania, ponieważ jest używany lub fprintf_s fwprintf_s.

Aby uzyskać więcej informacji na temat kodów zwracanych, zobacz errno, _doserrno, _sys_errlisti _sys_nerr.

Uwagi

fprintf formatuje i drukuje serię znaków i wartości do danych wyjściowych stream. Każda funkcja argument (jeśli istnieje) jest konwertowana i wyjściowa zgodnie z odpowiednią specyfikacją formatu w pliku format. W przypadku fprintfargumentu format ma taką samą składnię, jaką ma w elemecie printf.

fwprintfjest wersją o szerokim znaku fprintf; w , fwprintfformat jest ciągiem o szerokim znaku. Te funkcje zachowują się identycznie, jeśli strumień jest otwarty w trybie ANSI. fprintf obecnie nie obsługuje danych wyjściowych do strumienia UNICODE.

Wersje tych funkcji z sufiksem _l są identyczne, z tą różnicą, że używają parametru ustawień regionalnych przekazanych zamiast bieżących ustawień regionalnych wątku.

Ważne

Upewnij się, że format nie jest to ciąg zdefiniowany przez użytkownika.

Począwszy od systemu Windows 10 w wersji 2004 (kompilacja 19041), printf rodzina funkcji drukuje dokładnie możliwe liczby zmiennoprzecinkowe zgodnie z regułami IEEE 754 dotyczącymi zaokrąglania. W poprzednich wersjach systemu Windows dokładnie reprezentowane liczby zmiennoprzecinkowe kończące się na "5" zawsze zaokrągla się w górę. IEEE 754 stwierdza, że muszą zaokrąglić do najbliższej parzysta cyfra (znana również jako "Zaokrąglanie Bankiera"). Na przykład oba printf("%1.0f", 1.5) printf("%1.0f", 2.5) elementy i powinny być zaokrąglone do 2. Wcześniej 1,5 zaokrągliłoby się do 2 i 2,5 do 3. Ta zmiana dotyczy tylko dokładnie możliwych do reprezentowania liczb. Na przykład 2,35 (który, gdy jest reprezentowany w pamięci, jest bliżej 2,350000000000000008) nadal zaokrągla się do 2,4. Zaokrąglanie wykonywane przez te funkcje jest teraz również zgodne z trybem zaokrąglania zmiennoprzecinkowego ustawionym przez fesetround. Wcześniej zaokrąglanie zawsze wybierało FE_TONEAREST zachowanie. Ta zmiana dotyczy tylko programów utworzonych przy użyciu programu Visual Studio 2019 w wersji 16.2 lub nowszej. Aby użyć starszego zachowania zaokrąglania zmiennoprzecinkowego, połącz się z elementem "legacy_stdio_float_rounding.obj".

Mapowania funkcji tekstu ogólnego

Funkcja w kolumnie tchar.h jest mapowana na funkcję w innych kolumnach w zależności od zestawu znaków zdefiniowanego w czasie kompilacji.

Funkcja tchar.h _UNICODE i _MBCS niezdefiniowane _MBCS zdefiniowany _UNICODE zdefiniowany
_ftprintf fprintf fprintf fwprintf
_ftprintf_l _fprintf_l _fprintf_l _fwprintf_l

Aby uzyskać więcej informacji, zobacz Składnia specyfikacji formatu.

Wymagania

Function Wymagany nagłówek
fprintf, _fprintf_l <stdio.h>
fwprintf, _fwprintf_l <stdio.h> lub <wchar.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Przykład

// crt_fprintf.c
/* This program uses fprintf to format various
* data and print it to the file named FPRINTF.OUT. It
* then displays FPRINTF.OUT on the screen using the system
* function to invoke the operating-system TYPE command.
*/

#include <stdio.h>
#include <process.h>

FILE *stream;

int main( void )
{
   int    i = 10;
   double fp = 1.5;
   char   s[] = "this is a string";
   char   c = '\n';

   fopen_s( &stream, "fprintf.out", "w" );
   fprintf( stream, "%s%c", s, c );
   fprintf( stream, "%d\n", i );
   fprintf( stream, "%f\n", fp );
   fclose( stream );
   system( "type fprintf.out" );
}

this is a string
10
1.500000

Zobacz też

We/Wy strumienia
_cprintf, , _cprintf_l, , _cwprintf_cwprintf_l
fscanf, , _fscanf_l, , fwscanf_fwscanf_l
sprintf, , _sprintf_l, swprintf, , _swprintf_l_swprintf_l
Składnia specyfikacji formatu: printf i wprintf funkcje