fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l

Drukuj sformatowane dane do strumienia. Te funkcje to wersje programu fprintf, _fprintf_l, _fwprintf_lfwprintf z ulepszeniami zabezpieczeń zgodnie z opisem w temacie Funkcje zabezpieczeń w narzędziu CRT.

Składnia

int fprintf_s(
   FILE *stream,
   const char *format [,
   argument_list ]
);
int _fprintf_s_l(
   FILE *stream,
   const char *format,
   _locale_t locale [,
   argument_list ]
);
int fwprintf_s(
   FILE *stream,
   const wchar_t *format [,
   argument_list ]
);
int _fwprintf_s_l(
   FILE *stream,
   const wchar_t *format,
   _locale_t locale [,
   argument_list ]
);

Parametry

stream
Wskaźnik do FILE struktury.

format
Ciąg kontroli formatu.

argument_list
Opcjonalne argumenty dla ciągu formatu.

locale
Ustawienia regionalne do użycia.

Wartość zwracana

fprintf_s zwraca liczbę zapisanych bajtów. fwprintf_s Zwraca liczbę zapisanych znaków szerokich. Każda z tych funkcji zwraca wartość ujemną zamiast tego, gdy wystąpi błąd wyjściowy.

Uwagi

fprintf_s formatuje i drukuje serię znaków i wartości do danych wyjściowych stream. Każdy argument w pliku argument_list (jeśli istnieje) jest konwertowany i wyjściowy zgodnie z odpowiednią specyfikacją formatu w pliku format. Argument format używa składni specyfikacji formatu dla printf funkcji i wprintf .

fwprintf_sjest wersją o szerokim znaku fprintf_s; w , fwprintf_sformat jest ciągiem o szerokim znaku. Te funkcje zachowują się identycznie, jeśli strumień jest otwarty w trybie ANSI. fprintf_s 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.

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

Podobnie jak w przypadku wersji niezabezpieczonych (zobacz fprintf, fwprintf_fprintf_l, ,_fwprintf_l ), te funkcje weryfikują swoje parametry i wywołują nieprawidłową procedurę obsługi parametrów, zgodnie z opisem NULL w temacie Weryfikacja parametrów, jeśli stream jest to wskaźnik lub .format Sam ciąg formatu jest również weryfikowany. Jeśli istnieją jakiekolwiek nieznane lub nieprawidłowo sformułowane specyfikatory formatowania, te funkcje generują nieprawidłowy wyjątek parametru. We wszystkich przypadkach, jeśli wykonanie jest dozwolone do kontynuowania, funkcje zwracają wartość -1 i ustawiają wartość errnoEINVAL. Aby uzyskać więcej informacji na temat kodów zwracanych, zobacz errno, _doserrno, _sys_errlisti _sys_nerr.

Mapowania procedur tekstu ogólnego

TCHAR.H Rutynowych	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_ftprintf_s	fprintf_s	fprintf_s	fwprintf_s
_ftprintf_s_l	_fprintf_s_l	_fprintf_s_l	_fwprintf_s_l

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

Wymagania

Function	Wymagany nagłówek
fprintf_s, _fprintf_s_l	<stdio.h>
fwprintf_s, _fwprintf_s_l	<stdio.h> lub <wchar.h>

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

Przykład

// crt_fprintf_s.c
// This program uses fprintf_s to format various
// data and print it to the file named FPRINTF_S.OUT. It
// then displays FPRINTF_S.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_s.out", "w" );
   fprintf_s( stream, "%s%c", s, c );
   fprintf_s( stream, "%d\n", i );
   fprintf_s( stream, "%f\n", fp );
   fclose( stream );
   system( "type fprintf_s.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