fprintf, _fprintf_l, fwprintf, _fwprintf_l

Artykuł
06/09/2015

Drukowanie sformatowanych danych do strumienia.Bezpieczniejsze wersje te funkcje są dostępne; see fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l.

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, aby FILE struktury.
format
Ciąg formatu formantu.
argument
Opcjonalne argumenty.
locale
Ustawienia regionalne, aby użyć.

Wartość zwracana

fprintfZwraca liczbę zapisanych bajtów.fwprintfZwraca liczbę znaków szerokości napisane.Każda z tych funkcji zwraca wartość ujemną zamiast po wystąpieniu błędu danych wyjściowych.Jeśli stream lub format jest NULL, funkcje te wywołania obsługi nieprawidłowy parametr, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować, funkcje zwracają wartość -1 i errno do EINVAL.Ciąg formatu, który nie jest zaznaczone dla prawidłowych znaków formatowania, jak podczas korzystania z fprintf_s lub fwprintf_s.

Zobacz _doserrno, errno, _sys_errlist i _sys_nerr więcej informacji na temat tych i innych kodów błędów.

Uwagi

fprintfformaty i drukuje serii wartości w danych wyjściowych i znaki stream*.* Każda funkcja argument (jeśli ma zastosowanie) jest konwertowane i wyjściowe zgodnie ze specyfikacją odpowiedni format w format*.* Dla fprintf, format argumentu po tej samej składni i użycia, które ma w printf.

fwprintfjest to wersja szerokich znaków fprintf; w fwprintf, format jest łańcuch szerokich znaków.Funkcje te zachowują się identycznie, gdy strumień jest otwierany w trybie ANSI.fprintfaktualnie nie obsługuje dane wyjściowe do strumienia UNICODE.

Wersje te funkcje, z _l sufiks są identyczne, z wyjątkiem, że używają oni przekazany zamiast bieżące ustawienia regionalne wątku parametr ustawień regionalnych.

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

Tekst rodzajowy rutynowych mapowania

TCHAR.Rutynowe H	_UNICODE & Nie zdefiniowano _MBCS	_MBCS, definicja	_UNICODE, definicja
_ftprintf	fprintf	fprintf	fwprintf
_ftprintf_l	_fprintf_l	_fprintf_l	_fwprintf_l

Aby uzyskać więcej informacji, zobacz Specyfikacji formatu.

Wymagania

Funkcja	Wymaganego nagłówka
fprintf, _fprintf_l	<stdio.h>
fwprintf, _fwprintf_l	<stdio.h> lub <wchar.h>

Aby uzyskać dodatkowe informacje o zgodności, zobacz zgodności we wprowadzeniu.

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" );
}