fread(3)                   Library Functions Manual                   fread(3)

NUME
       fread, fwrite - intrare/ie<?>ire a fluxurilor binare

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #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);

DESCRIERE
       Func<?>ia fread() cite<?>te nmemb elemente de date, fiecare cu lungimea
       de size octe<?>i, din fluxul indicat de stream, stocandu-le la
       loca<?>ia indicata de ptr.

       Func<?>ia fwrite() scrie nmemb elemente de date, fiecare cu o lungime
       de size octe<?>i, in fluxul indicat de stream, ob<?>inandu-le din
       loca<?>ia data de ptr.

       Pentru varianta corespondenta fara blocare, a se vedea
       unlocked_stdio(3).

VALOAREA RETURNATA
       In caz de succes, fread() <?>i fwrite() returneaza numarul de elemente
       citite sau scrise.  Acest numar este egal cu numarul de octe<?>i
       transfera<?>i numai atunci cand size este 1. Daca apare o eroare sau
       daca se ajunge la sfar<?>itul fi<?>ierului, valoarea returnata este un
       numar scurt de elemente (sau zero).

       Indicatorul de pozi<?>ie al fi<?>ierului pentru flux este avansat cu
       numarul de octe<?>i citi<?>i sau scri<?>i cu succes.

       fread() nu face distinc<?>ie intre end-of-file (sfar<?>itul de
       fi<?>ier) <?>i eroare, iar apelan<?>ii trebuie sa utilizeze feof(3)
       <?>i ferror(3) pentru a determina ce a avut loc.

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +--------------------------------------+---------------------+---------+
       |Interfa<?>a                           | Atribut             | Valoare |
       +--------------------------------------+---------------------+---------+
       |fread(), fwrite()                     | Siguran<?>a firelor | MT-Safe |
       +--------------------------------------+---------------------+---------+
STANDARDE
       C11, POSIX.1-2008.

ISTORIC
       POSIX.1-2001, C89.

EXEMPLE
       Programul de mai jos demonstreaza utilizarea fread() analizand
       executabilul /bin/sh ELF in modul binar <?>i imprimand numarul magic
       <?>i clasa acestuia:

           $ ./a.out
           ELF magic: 0x7f454c46
           Class: 0x02

   Sursa programului
       #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() a e<?>uat: %zu\n", ret);
               exit(EXIT_FAILURE);
           }

           printf("numarul magic 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() a e<?>uat: %zu\n", ret);
               exit(EXIT_FAILURE);
           }

           printf("Clasa: %#04x\n", buffer[0]);

           fclose(fp);

           exit(EXIT_SUCCESS);
       }

CONSULTA<?>I <?>I
       read(2), write(2), feof(3), ferror(3), unlocked_stdio(3)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.06 31 octombrie 2023                      fread(3)