#include <stdio.h> // <cstdio> en C++
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.
blocSize
et blocCount
.
size_t
renvoie
normalement vers unsigned long
.
fopen
.
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.
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.
#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; }
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 :