ИМЯ¶

fread, fwrite - ввод/вывод из двоичного потока

БИБЛИОТЕКА¶

Стандартная библиотека языка C (libc, -lc)

СИНТАКСИС¶

#include <stdio.h>

size_t fread(void ptr[restrict .size * .nmemb],
             size_t size, size_t nmemb,
             FILE *restrict stream);
size_t fwrite(const void ptr[restrict .size * .nmemb],
             size_t size, size_t nmemb,
             FILE *restrict stream);

ОПИСАНИЕ¶

Функция fread() считывает nmemb единиц данных (размер каждого size байт) из потока, на который указывает stream, и сохраняет их в расположение, на которое указывает ptr.

Функция fwrite() записывает nmemb единиц данных (размер каждого size байт) в поток, на который указывает stream, получая их из расположения, на которое указывает ptr.

Для неблокирующих аналогов, см. unlocked_stdio(3).

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶

При успешном выполнении функции fread() и fwrite() возвращают количество считанных или записанных единиц. Это количество равно количеству переданных байт только, если значение size равно 1. В случае ошибки или по достижении конца файла возвращается меньшее количество единиц (или ноль).

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

Функция fread() не отличает возникновение ошибки и достижения конца файла; для точного определения необходимо вызывать функции feof(3) и ferror(3).

АТРИБУТЫ¶

Описание терминов данного раздела смотрите в attributes(7).

СТАНДАРТЫ¶

C11, POSIX.1-2008.

ИСТОРИЯ¶

POSIX.1-2001, C89.

ПРИМЕРЫ¶

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;


    size_t         ret;


    unsigned char  buffer[4];


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


    if (!fp) {


        perror("fopen");


        return EXIT_FAILURE;


    }


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


    if (ret != ARRAY_SIZE(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);
}

СМОТРИТЕ ТАКЖЕ¶

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

ПЕРЕВОД¶

Русский перевод этой страницы руководства разработал(и) Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.