Exporter (0) Imprimer
Développer tout
and
div
eof
not
or
xor
Développer Réduire
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

fread_s

size_t fread_s( 
   void *buffer,
   size_t bufferSize,
   size_t elementSize,
   size_t count,
   FILE *stream 
);

buffer

Emplacement de stockage pour les données.

bufferSize

Taille en octets, de la mémoire tampon désirée.

elementSize

Taille de l'élément en lecture en octets.

count

Nombre maximal d'éléments à lire.

stream

Pointeur vers la structure FILE.

fread_s retourne le nombre d'éléments (entier) qui ont été lu0s dans la mémoire tampon, qui peut être moins que count si une erreur de lecture ou la fin du fichier est rencontrée avant count soit atteint. Utilisez la fonction feof ou ferror pour distinguer une erreur de lecture d'une condition de fin du fichier. Si size ou count est 0, fread_s retourne 0 et le contenu de la mémoire tampon reste inchangé. Si stream ou buffer est un pointeur null, fread_s appelle le gestionnaire de paramètres non valides, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, cette fonction définit errno à la valeur EINVAL et retourne 0.

Consultez _doserrno, errno, _sys_errlist et _sys_nerr pour plus d'informations sur ces éléments et autres codes d'erreur.

La fonction fread_s lit jusqu'à count les éléments des octets elementSize de l'entrée stream et les stocke dans buffer. Le pointeur de fichier associé à stream (s'il y en a un) est augmenté par le nombre d'octets réellement lus. Si le flux de données spécifié est ouvert en mode texte, les paires saut de ligne-retour chariot sont remplacées par des caractères de saut de ligne. Le remplacement n'a aucun effet sur le pointeur de fichier ou la valeur de retour. La position du pointeur de fichier est indéterminée si une erreur se produit. La valeur d'un élément partiellement lu ne peut pas être déterminée.

Cette fonction verrouille d'autres threads. Si vous avez besoin d'une version non verrouillante, utilisez _fread_nolock.

Fonction

En-tête requis

fread_s

<stdio.h>

Pour plus d'informations sur la compatibilité, consultez Compatibilité.


// crt_fread_s.c
// Command line: cl /EHsc /nologo /W4 crt_fread_s.c
//
// This program opens a file that's named FREAD.OUT and
// writes characters to the file. It then tries to open
// FREAD.OUT and read in characters by using fread_s. If the attempt succeeds,
// the program displays the number of actual items read.
 
#include <stdio.h>

#define BUFFERSIZE 30
#define DATASIZE 22
#define ELEMENTCOUNT 2
#define ELEMENTSIZE (DATASIZE/ELEMENTCOUNT)
#define FILENAME "FREAD.OUT"

int main( void )
{
   FILE *stream;
   char list[30];
   int  i, numread, numwritten;

   for ( i = 0; i < DATASIZE; i++ )
      list[i] = (char)('z' - i);
   list[DATASIZE] = '\0'; // terminal null so we can print it
      
   // Open file in text mode:
   if( fopen_s( &stream, FILENAME, "w+t" ) == 0 )
   {
      // Write DATASIZE characters to stream 
      printf( "Contents of buffer before write/read:\n\t%s\n\n", list );
      numwritten = fwrite( list, sizeof( char ), DATASIZE, stream );
      printf( "Wrote %d items\n\n", numwritten );
      fclose( stream );
   } else {
      printf( "Problem opening the file\n" );
      return -1;
   }

   if( fopen_s( &stream, FILENAME, "r+t" ) == 0 )   {
      // Attempt to read in characters in 2 blocks of 11
      numread = fread_s( list, BUFFERSIZE, ELEMENTSIZE, ELEMENTCOUNT, stream );
      printf( "Number of %d-byte elements read = %d\n\n", ELEMENTSIZE, numread );
      printf( "Contents of buffer after write/read:\n\t%s\n", list );
      fclose( stream );
   } else {
      printf( "File could not be opened\n" );
      return -1;
   }
}

Contenu de la mémoire tampon avant l'écriture/lecture : 
        zyxwvutsrqponmlkjihgfe

A écrit 22 éléments

Le nombre de 11 éléments d'octets indique = 2

Contenu de la mémoire tampon après écriture/lecture : 
        zyxwvutsrqponmlkjihgfe

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft