База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

fwrite — функция за поток в C23

`fwrite(ptr, size, nmemb, stream)` от `<stdio.h>` записва в поток до `nmemb` обекта по `size` байта от масива, посочен от `ptr`. Всеки обект се обработва като последователни извиквания на `fputc` върху представянето му като `unsigned char`; резултатът брои напълно записаните обекти.

Версия: C23

Синтаксис

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

fwrite(ptr, size, nmemb, stream) от <stdio.h> записва в поток до nmemb обекта по size байта от масива, посочен от ptr. Всеки обект се обработва като последователни извиквания на fputc върху представянето му като unsigned char; резултатът брои напълно записаните обекти.

Примерът записва три стойности int чрез fwrite(values, sizeof values[0], 3, stream), което връща 3. След връщане в началото ги чете със същия тип и печата 3 7 -2 42; броячът е в елементи, не в байтове.

Резултат под nmemb означава грешка при запис; проверете и ferror, защото байтове от частичния последен обект може вече да са записани. Ако size или nmemb е нула, връща нула и състоянието на потока не се променя. Източникът трябва да покрива size * nmemb байта. Суровите представяния може да имат padding и да зависят от endian и ширини на типовете, затова не са преносим формат.

Примери

#include <stdio.h>
int main(void){int values[3]={7,-2,42},copy[3]={0};FILE *stream=tmpfile();if(!stream)return 1;size_t written=fwrite(values,sizeof values[0],3,stream);rewind(stream);if(fread(copy,sizeof copy[0],3,stream)!=3){fclose(stream);return 1;}printf("%zu %d %d %d\n",written,copy[0],copy[1],copy[2]);return fclose(stream)==0?0:1;}

Резултат

3 7 -2 42

Примерът записва три стойности `int` чрез `fwrite(values, sizeof values[0], 3, stream)`, което връща `3`. След връщане в началото ги чете със същия тип и печата `3 7 -2 42`; броячът е в елементи, не в байтове.

Източници