Participer au site avec un Tip
Rechercher
 

Améliorations / Corrections

Vous avez des améliorations (ou des corrections) à proposer pour ce document : je vous remerçie par avance de m'en faire part, cela m'aide à améliorer le site.

Emplacement :

Description des améliorations :

Fonction fread

Entête à inclure

#include <stdio.h>  // <cstdio> en C++

Fonction fread

size_t fread( void * buffer, size_t blocSize, size_t blocCount, FILE * stream );                       // Avant C99
size_t fread( void * restrict buffer, size_t blocSize, size_t blocCount, FILE * restrict stream );     // A partir de C99

Cette fonction permet de lire un certain nombre d'octets à partir d'un flux. L'ensemble des octets lu seront stockés dans un buffer passé en premier paramètre : il faut donc être certain que le buffer est bien de taille suffisante, par rapport à la taille des données demandées. Pour spécifier le nombre d'octets à lire, il faut jouer sur deux paramètres : le nombre de bloc d'octets à lire ainsi que la taille de chacun des blocs. La taille totale du buffer à allouer sera donc le produit de ces deux tailles précédentes.

Paramètres

Valeur de retour

Renvoie le nombre de blocs lus (attention, cette valeur n'est pas exprimée en nombre d'octets, mais bien en nombre de blocs). Si cette valeur est inférieure à la valeur initialement demandée, alors soit vous êtes arrivé en fin de fichier, soit une erreur de lecture vient de survenir. Pour distinguer les deux cas vous pouvez invoquer les fonctions feof et ferror : respectivement pour savoir qu'on est en fin de fichier ou qu'une erreur est survenue.

Dans le cas ou une erreur viendrait de survenir, il vous faudra alors consulter la variable errno pour obtenir plus de détails sur la nature exacte de l'erreur constatée.

Codes erreurs pouvant être retournés

EAGAIN : le descripteur de flux est marqué comme non-bloquant et aucune données n'est disponible pour l'instant. Il faudra retenter la lecture ultérieurement.

EBADF : le descripteur de flux (FILE *) passé en paramètre est invalide.

EINTR : la lecture sur une ressource lente a été interrompue par l'arrivée d'un signal avant que des données ne soient disponibles.

EIO : une erreur d'accès physique au flux vient d'être générée.

Exemple de code

#include <stdio.h>
#include <stdlib.h>
#include <time.h>


const char * filename = "./test.data";

#define BLOCK_SIZE 24
#define BLOCK_COUNT 10

void writeFile( const char * filename ) {
    char buffer[ BLOCK_SIZE ];
    int returnCode;
    int index;

    FILE * stream = fopen( filename, "w" );
    if ( stream == NULL ) {
        fprintf( stderr, "Cannot open file for writing\n" );
        exit( -1 );
    }

    for( index=0; index<BLOCK_COUNT; index++ ) {
        int value = rand() % 1000;
        sprintf( buffer, "| User %3d | Pass %3d |\n", value, 999-value );
        if ( 1 != fwrite( buffer, BLOCK_SIZE, 1, stream ) ) {
            fprintf( stderr, "Cannot write block in file\n" );
        }
    }

    returnCode = fclose( stream );
    if ( returnCode == EOF ) {
        fprintf( stderr, "Cannot close file\n" );
        exit( -1 );
    }
}

void readFile( const char * filename ) {
    int returnCode;
    int count;

    FILE * stream = fopen( filename, "r" );
    if ( stream == NULL ) {
        fprintf( stderr, "Cannot open file for reading\n" );
        exit( -1 );
    }

    printf( "How many blocks to read: " );
    scanf( "%d", &count );

    {
        char buffer[ BLOCK_SIZE * count + 1];
        if ( count != fread( buffer, BLOCK_SIZE, count, stream ) ) {
            fprintf( stderr, "Cannot read blocks in file\n" );
        }
        buffer[ BLOCK_SIZE * count ] = '\0';
        printf( buffer );
    }

    returnCode = fclose( stream );
    if ( returnCode == EOF ) {
        fprintf( stderr, "Cannot close file\n" );
        exit( -1 );
    }
}


int main() {

    srand( time( NULL ) );

    writeFile( filename );
    readFile( filename );

    return 0;
}

Sujets connexes

fopen
fwrite
fclose