fRead
Lê dados de um fluxo.
size_t fread(
void *buffer,
size_t size,
size_t count,
FILE *stream
);
Parâmetros
buffer
Local de armazenamento de dados.size
Tamanho em bytes do item.count
Número máximo de itens a serem lidos.stream
Ponteiro para FILE estrutura.
Valor de retorno
freadRetorna o número de itens completos, na verdade, ler, que pode ser menor do que count se ocorrer um erro ou se o final do arquivo for encontrado antes de alcançar count*.* Use o feof ou ferror a função para diferenciar um erro de leitura de uma condição de fim-de-arquivo.Se size ou count é 0, fread retorna 0 e o conteúdo do buffer permanecem inalterado.Se stream ou buffer é um ponteiro nulo, fread chama o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, essa função define errno para EINVAL e retorna 0.
Consulte _doserrno, errno, _sys_errlist e _sys_nerr para obter mais informações sobre estes e outros, códigos de erro.
Comentários
O fread função lê até count itens do size bytes provenientes da entrada stream e as armazena em buffer*.* O ponteiro de arquivo associado stream (se houver) é aumentado pelo número de bytes lidos de fato.Se determinado fluxo for aberto no modo de texto, os pares do carro e alimentação de linha são substituídos por caracteres de avanço de linha única.A substituição não tem efeito sobre o ponteiro de arquivo ou o valor de retorno.A posição do ponteiro de arquivo é um estado indeterminada se ocorrer um erro.Não é possível determinar o valor de um item de leitura parcialmente.
Esta função bloqueia outros segmentos.Se você precisar de uma versão não-bloqueio, use _fread_nolock.
Requisitos
Função |
Cabeçalho necessário |
|---|---|
fread |
<stdio.h> |
Para obter informações adicionais de compatibilidade, consulte compatibilidade na introdução.
Exemplo
// crt_fread.c
// This program opens a file named FREAD.OUT and
// writes 25 characters to the file. It then tries to open
// FREAD.OUT and read in 25 characters. If the attempt succeeds,
// the program displays the number of actual items read.
#include <stdio.h>
int main( void )
{
FILE *stream;
char list[30];
int i, numread, numwritten;
// Open file in text mode:
if( fopen_s( &stream, "fread.out", "w+t" ) == 0 )
{
for ( i = 0; i < 25; i++ )
list[i] = (char)('z' - i);
// Write 25 characters to stream
numwritten = fwrite( list, sizeof( char ), 25, stream );
printf( "Wrote %d items\n", numwritten );
fclose( stream );
}
else
printf( "Problem opening the file\n" );
if( fopen_s( &stream, "fread.out", "r+t" ) == 0 )
{
// Attempt to read in 25 characters
numread = fread( list, sizeof( char ), 25, stream );
printf( "Number of items read = %d\n", numread );
printf( "Contents of buffer = %.25s\n", list );
fclose( stream );
}
else
printf( "File could not be opened\n" );
}