Scroll to navigation

fread(3) Library Functions Manual fread(3)

NAZWA

fread, fwrite - odczytuje/zapisuje strumień binarny

BIBLIOTEKA

Standardowa biblioteka C (libc, -lc)

SKŁADNIA

#include <stdio.h>
size_t fread(void ptr[restrict .size * .nmemb],
             size_t size, size_t nmemb,
             FILE *restrict stream);
size_t fwrite(const void ptr[restrict .size * .nmemb],
             size_t size, size_t nmemb,
             FILE *restrict stream);

OPIS

Funkcja fread() odczytuje nmemb elementów danych, każdy o rozmiarze size bajtów, ze strumienia wskazywanego przez stream, do miejsca w pamięci wskazywanego przez ptr.

Funkcja fwrite() zapisuje nmemb elementów danych, każdy o rozmiarze size bajtów, do strumienia wskazywanego przez stream, pobierając je z miejsca w pamięci wskazywanego przez ptr.

Informacje o nieblokujących odpowiednikach znajdują się w unlocked_stdio(3).

WARTOŚĆ ZWRACANA

Funkcje fread() oraz fwrite(), jeśli się powiodą, zwracają liczbę faktycznie odczytanych lub zapisanych elementów. Ta liczba jest równa liczne przesłanych bajtów tylko wtedy, gdy size wynosi 1. Jeśli wystąpi błąd lub osiągnięty zostanie koniec pliku, zwracana jest zmniejszona liczba elementów (lub zero).

Wskaźnik pozycji pliku jest przesuwany o liczbę pomyślnie odczytanych lub zapisanych bajtów.

Funkcja fread() nie rozróżnia pomiędzy końcem pliku a błędem, należy w tym celu wywołać funkcję feof(3) oraz ferror(3).

ATRYBUTY

Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).

Interfejs Atrybut Wartość
fread(), fwrite() Bezpieczeństwo wątkowe MT-bezpieczne

STANDARDY

C11, POSIX.1-2008.

HISTORIA

POSIX.1-2001, C89.

PRZYKŁADY

Program poniżej demonstruje użycie fread(), przez analizę pliku wykonywalnego ELF /bin/sh w trybie binarnym i wypisanie jego magii i klasy:


$ ./a.out
Magia ELF: 0x7f454c46
Klasa: 0x02

Kod źródłowy programu

#include <stdio.h>
#include <stdlib.h>
#define ARRAY_SIZE(arr) (sizeof(arr) / sizeof((arr)[0]))
int
main(void)
{

FILE *fp;
size_t ret;
unsigned char buffer[4];
fp = fopen("/bin/sh", "rb");
if (!fp) {
perror("fopen");
return EXIT_FAILURE;
}
ret = fread(buffer, sizeof(*buffer), ARRAY_SIZE(buffer), fp);
if (ret != ARRAY_SIZE(buffer)) {
fprintf(stderr, "fread() zawiodło: %zu\n", ret);
exit(EXIT_FAILURE);
}
printf("Magia ELF: %#04x%02x%02x%02x\n", buffer[0], buffer[1],
buffer[2], buffer[3]);
ret = fread(buffer, 1, 1, fp);
if (ret != 1) {
fprintf(stderr, "fread() zawiodło: %zu\n", ret);
exit(EXIT_FAILURE);
}
printf("Klasa: %#04x\n", buffer[0]);
fclose(fp);
exit(EXIT_SUCCESS); }

ZOBACZ TAKŻE

read(2), write(2), feof(3), ferror(3), unlocked_stdio(3)

TŁUMACZENIE

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Adam Byrtek <alpha@irc.pl>, Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.

2 maja 2024 r. Linux man-pages 6.8