fread(3)

NAZWA
fread, fwrite - odczytuje/zapisuje strumień binarny

BIBLIOTEKA
Standardowa biblioteka C (libc, -lc)

SKŁADNIA
#include <stdio.h>

size_t fread(size_t size, size_t n;
             void ptr[restrict size * n],
             size_t size, size_t n,
             FILE *restrict stream);
size_t fwrite(size_t size, size_t n;
             const void ptr[restrict size * n],
             size_t size, size_t n,
             FILE *restrict stream);

OPIS
Funkcja fread() odczytuje n 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 n 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 <stdcountof.h>
    #include <stdio.h>
    #include <stdlib.h>

    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), countof(buffer), fp);
        if (ret != countof(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
Tłumaczenie niniejszej strony podręcznika: 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 (https://www.gnu.org/licenses/gpl-3.0.html) 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.