fread_s

Čte data ze streamu. Tato verze fread má vylepšení zabezpečení, jak je popsáno v funkcích zabezpečení v CRT.

Syntaxe

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

Parametry

buffer
Umístění úložiště pro data

bufferSize
Velikost cílové vyrovnávací paměti v bajtech.

elementSize
Velikost položky, která se má číst v bajtech

count
Maximální počet položek, které se mají přečíst.

stream
Ukazatel na FILE strukturu.

Vrácená hodnota

fread_s vrátí počet (celých) položek, které byly načteny do vyrovnávací paměti, což může být menší než count v případě, že je zjištěna chyba čtení nebo konec souboru před count dosažením. feof K rozlišení chyby od podmínky ukončení souboru použijte funkci nebo ferror funkci. Pokud size nebo count je 0, fread_s vrátí hodnotu 0 a obsah vyrovnávací paměti se nezmění. Pokud stream nebo buffer je ukazatel null, fread_s vyvolá neplatnou obslužnou rutinu parametru, jak je popsáno v ověření parametru. Pokud je spuštění povoleno pokračovat, tato funkce nastaví errnoEINVAL hodnotu 0 a vrátí hodnotu 0.

Další informace o kódech chyb naleznete v tématu errno, _doserrno, _sys_errlista _sys_nerr.

Poznámky

Funkce fread_s čte z vstupu stream až count položky elementSize bajtů a ukládá je do buffer. Ukazatel souboru, ke kterému je přidružený stream (pokud existuje) je rozšířený podle počtu přečtených fread_s bajtů. Pokud je daný datový proud otevřen v textovém režimu, nahradí se dvojice návratového kanálu řádku jedním řádkem. Nahrazení nemá žádný vliv na ukazatel souboru ani na vrácenou hodnotu. Umístění ukazatele souboru je neurčité, pokud dojde k chybě. Hodnotu částečně přečtené položky nelze určit.

Tato funkce uzamkne další vlákna. Pokud požadujete neblokovací verzi, použijte _fread_nolock.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Požadavky

Function	Požadovaný hlavičkový soubor
fread_s	<stdio.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Příklad

// 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;
   }
}

Contents of buffer before write/read:
        zyxwvutsrqponmlkjihgfe

Wrote 22 items

Number of 11-byte elements read = 2

Contents of buffer after write/read:
        zyxwvutsrqponmlkjihgfe

Viz také

Vstupně-výstupní operace streamu
fwrite
_read