Movatterモバイル変換


[0]ホーム

URL:


cppreference.com
Namespaces
Variants
    Actions

      fwrite

      From cppreference.com
      <c‎ |io
       
       
      File input/output
      Types and objects
      Functions
      File access
      Unformatted input/output
      (C95)(C95)
      (C95)
      (C95)(C95)
      (C95)
      (C95)

      Formatted input
       
      Defined in header<stdio.h>
      size_t fwrite(constvoid* buffer,size_t size,size_t count,
                     FILE* stream);
      (until C99)
      size_t fwrite(constvoid*restrict buffer,size_t size,size_t count,
                     FILE*restrict stream);
      (since C99)

      Writescount of objects from the given arraybuffer to the output streamstream. The objects are written as if by reinterpreting each object as an array ofunsignedchar and callingfputcsize times for each object to write thoseunsignedchars intostream, in order. The file position indicator for the stream is advanced by the number of characters written.

      If an error occurs, the resulting value of the file position indicator for the stream is indeterminate.

      Contents

      [edit]Parameters

      buffer - pointer to the first object in the array to be written
      size - size of each object
      count - the number of the objects to be written
      stream - pointer to the output stream

      [edit]Return value

      The number of objects written successfully, which may be less thancount if an error occurs.

      Ifsize orcount is zero,fwrite returns zero and performs no other action.

      [edit]Example

      Run this code
      #include <assert.h>#include <stdio.h>#include <stdlib.h> enum{ SIZE=5}; int main(void){double a[SIZE]={1,2,3,4,5};FILE* f1=fopen("file.bin","wb");assert(f1);size_t r1= fwrite(a,sizeof a[0], SIZE, f1);printf("wrote %zu elements out of %d requested\n", r1, SIZE);fclose(f1); double b[SIZE];FILE* f2=fopen("file.bin","rb");size_t r2=fread(b,sizeof b[0], SIZE, f2);fclose(f2);printf("read back: ");for(size_t i=0; i< r2;++i)printf("%0.2f ", b[i]);}

      Output:

      wrote 5 elements out of 5 requestedread back: 1.00 2.00 3.00 4.00 5.00

      [edit]References

      • C23 standard (ISO/IEC 9899:2024):
      • 7.21.8.2 The fwrite function (p: TBD)
      • C17 standard (ISO/IEC 9899:2018):
      • 7.21.8.2 The fwrite function (p: TBD)
      • C11 standard (ISO/IEC 9899:2011):
      • 7.21.8.2 The fwrite function (p: 335-336)
      • C99 standard (ISO/IEC 9899:1999):
      • 7.19.8.2 The fwrite function (p: 301-302)
      • C89/C90 standard (ISO/IEC 9899:1990):
      • 4.9.8.2 The fwrite function

      [edit]See also

      prints formatted output tostdout, a file stream or a buffer
      (function)[edit]
      writes a character string to a file stream
      (function)[edit]
      reads from a file
      (function)[edit]
      Retrieved from "https://en.cppreference.com/mwiki/index.php?title=c/io/fwrite&oldid=160133"

      [8]ページ先頭

      ©2009-2025 Movatter.jp