fprintf

[funkcja] Zapisuje tekst sformatowany do wskazanego strumienia.

Składnia

#include <cstdio>

int fprintf( FILE * stream, const char * format,...);

Argumenty

Argument	Opis
FILE *stream	Określa strumień na którym ma zostać wykonana operacja.
const char *format	Patrz: _{» standard C ♦}tekst sformatowany - printf.
...	Opcjonalne argumenty - typy argumentów oraz ich kolejność muszą być zgodne z tagami jakie wystąpiły w tekście sformatowanym (argument `format`).

Zwracana wartość

Zwraca liczbę bajtów zapisanych do strumienia w przypadku sukcesu. Funkcja zwraca wartość ujemną w przypadku wystąpienia błędu.

Opis szczegółowy

Funkcja zapisuje tekst sformatowany do wskazanego strumienia. Omawiana funkcja wymaga, aby liczba argumentów przekazanych do funkcji była nie mniejsza niż wynika to z treści tekstu sformatowanego. Przekazanie większej liczby argumentów niż jest to wymagane nie spowoduje żadnych skuktów ubocznych.

Znaczenie argumentu format jest takie samo jak dla funkcji _{» standard C ♦}printf.

Uwaga! Upewnij się, że tekst sformatowany nie może być wprowadzany przez użytkownika. Więcej szczegółów w dokumencie: _{» standard C ♦}tekst sformatowany - printf.

Dodatkowe informacje

Niniejsza funkcja w przypadku wystąpienia błędu ustawia dodatkowo kod błędu _{» standard C ♦}errno. Standard nie określa jednak ustawianej wartości, więc kod błędu należy weryfikować w dokumentacji zgodnej z posiadanym kompilatorem.

Przykład

#include <cstdio>

int main()
{
FILE * pStrumien = stdout;

fprintf( pStrumien, "Znaki: %c, %c\n", 'h', 68 );
fprintf( pStrumien, "Liczby (1): %d %i\n", 23, 45 );
fprintf( pStrumien, "Liczby (2): %5d %0*d\n", 1234, 8, 5678 );
fprintf( pStrumien, "Lancuchy znakow: %s, %s\n", "napis pierwszy", "napis drugi" );
fprintf( pStrumien, "Systemy liczbowe: %d %x %o %#x %#o \n", 250, 250, 250, 250, 250 );
fprintf( pStrumien, "Liczby zmiennoprzecinowe: %4.2f %+.0e %E \n", 2.1254, 2.1254, 2.1254 );
fprintf( pStrumien, "Liczba bez zer wiadacych: %7d \n", 1387 );
fprintf( pStrumien, "Liczba z zerami wiadocymi: %07d \n", 1387 );
return 0;
}

Standardowe wyjście programu

Znaki: h, D
Liczby (1): 23 45
Liczby (2): 1234 00005678
Lancuchy znakow: napis pierwszy, napis drugi
Systemy liczbowe: 250 fa 372 0xfa 0372
Liczby zmiennoprzecinowe: 2.13 +2e+000 2.125400E+000
Liczba bez zer wiadacych: 1387
Liczba z zerami wiadocymi: 0001387

Zagadnienia powiązane

fscanf	Odczytuje znak z pliku. (funkcja)
tekst sformatowany - printf	Specyfikacja tekstu sformatowanego dla funkcji printf. (specyfikacja)
printf	Wypisuje tekst sformatowany na standardowym strumieniu wyjścia. (funkcja)
vfprintf	Zapisuje tekst sformatowany do wskazanego strumienia. Wartości podstawiane do tekstu sformatowanego przekazywane są poprzez wskaźnik na listę argumentów. (funkcja)

Linki zewnętrzne

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.