NOME¶

fread, fwrite - entrada/saída de fluxo binário

SINOPSE¶

#include <stdio.h>

size_t fread(void *ptr, size_t size, size_t nmemb, ARQUIVO *stream);

size_t fwrite(const void *ptr, size_t size, size_t nmemb,
              ARQUIVO *stream);

DESCRIÇÃO¶

A função fread() lê nmemb elementos de dados, cada um com size bytes, do fluxo apontado por stream, armazenando-os no local dado por ptr.

A função fwrite() escreve nmemb elementos de dado, cada um com size bytes, no fluxo apontado por stream, obtendo-os a partir do local dado por ptr.

Para contrapartes não bloqueantes, veja unlocked_stdio(3).

VALOR DE RETORNO¶

On success, fread() and fwrite() return the number of items read or written. This number equals the number of bytes transferred only when size is 1. If an error occurs, or the end of the file is reached, the return value is a short item count (or zero).

The file position indicator for the stream is advanced by the number of bytes successfully read or written.

fread() nãi distingue entre fim de arquivo e erro, e os chamadores precisam usar feof(3) e ferror(3) para determinar o que ocorreu.

ATRIBUTOS¶

Para uma explicação dos termos usados nesta seção, consulte attributes(7).

DE ACORDO COM¶

POSIX.1-2001, POSIX.1-2008, C89.

EXEMPLOS¶

The program below demonstrates the use of fread() by parsing /bin/sh ELF executable in binary mode and printing its magic and class:

$ ./a.out
ELF magic: 0x7f454c46
Class: 0x02

#include <stdio.h>
#include <stdlib.h>
#define ARRAY_SIZE(arr) (sizeof(arr) / sizeof((arr)[0]))
int
main(void)
{


    FILE *fp = fopen("/bin/sh", "rb");


    if (!fp) {


        perror("fopen");


        return EXIT_FAILURE;


    }


    unsigned char buffer[4];


    size_t ret = fread(buffer, ARRAY_SIZE(buffer), sizeof(*buffer), fp);


    if (ret != sizeof(*buffer)) {


        fprintf(stderr, "fread() failed: %zu\n", ret);


        exit(EXIT_FAILURE);


    }


    printf("ELF magic: %#04x%02x%02x%02x\n", buffer[0], buffer[1],


           buffer[2], buffer[3]);


    ret = fread(buffer, 1, 1, fp);


    if (ret != 1) {


        fprintf(stderr, "fread() failed: %zu\n", ret);


        exit(EXIT_FAILURE);


    }


    printf("Class: %#04x\n", buffer[0]);


    fclose(fp);


    exit(EXIT_SUCCESS);
}

VEJA TAMBÉM¶

read(2), write(2), feof(3), ferror(3), unlocked_stdio(3)

COLOFÃO¶

Esta página faz parte da versão 5.10 do projeto Linux man-pages. Uma descrição do projeto, informações sobre relatórios de bugs e a versão mais recente desta página podem ser encontradas em https://www.kernel.org/doc/man-pages/.

TRADUÇÃO¶

A tradução para português brasileiro desta página man foi criada por Rubens de Jesus Nogueira <darkseid99@usa.net> e André Luiz Fassone <lonely_wolf@ig.com.br>

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.