fread(3)                   Library Functions Manual                   fread(3)

NOM
       fread, fwrite - Entrees/sorties binaires sur un flux

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <stdio.h>

       size_t fread(void ptr[restrict .taille * .nmemb],
                    size_t taille, size_t nmemb,
                    FILE *restrict flux);
       size_t fwrite(const void ptr[restrict .taille * .nmemb],
                    size_t taille, size_t nmemb,
                    FILE *restrict flux);

DESCRIPTION
       La fonction fread() lit nbelem elements de donnees de taille octets
       chacun depuis le flux pointe par flux, et les stocke a l'emplacement
       pointe par ptr.

       La fonction fwrite() ecrit nbelem elements de donnees de taille octets
       chacun dans le flux pointe par flux, apres les avoir recuperes depuis
       l'emplacement pointe par ptr.

       Pour des versions de ces fonctions ignorant les verrouillages, voir
       unlocked_stdio(3).

VALEUR RENVOYEE
       En cas de reussite, fread() et fwrite() renvoient le nombre d'elements
       lus ou ecrits. Ce nombre n'est egal au nombre d'octets transferes que
       si taille est egal a 1. Si une erreur se produit, ou si la fin du
       fichier est atteinte en lecture, le nombre renvoye est plus petit que
       nbelem et peut meme etre nul.

       L'indicateur de position du flux est incremente du nombre d'octets
       ayant ete lus ou ecrits avec succes.

       fread() ne fait pas la difference entre la fin de fichier et une
       erreur, et l'appelant devra utiliser feof(3) et ferror(3) pour le
       savoir.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +---------------------------------+--------------------------+---------+
       |Interface                        | Attribut                 | Valeur  |
       +---------------------------------+--------------------------+---------+
       |fread(), fwrite()                | Securite des threads     | MT-Safe |
       +---------------------------------+--------------------------+---------+
STANDARDS
       C11, POSIX.1-2008.

HISTORIQUE
       POSIX.1-2001, C89.

EXEMPLES
       Le programme ci-dessous montre l'utilisation de fread() pour parcourir
       l'executable ELF /bin/sh en mode binaire et afficher son code magique
       et sa classe :

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

   Source du programme
       #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 echoue : %zu\n", ret);
               exit(EXIT_FAILURE);
           }

           printf("ELF magic: %#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 echoue : %zu\n", ret);
               exit(EXIT_FAILURE);
           }

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

           fclose(fp);

           exit(EXIT_SUCCESS);
       }

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

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org>, Frederic Hantrais <fhantrais@gmail.com> et Lucien
       Gentis <lucien.gentis@waika9.com>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.8      2 mai 2024                          fread(3)