std::fwrite

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

入出力ライブラリ

I/Oマニピュレータ

出力関数 (C++23)

C形式I/O

バッファ

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

ストリーム

抽象化

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

ファイルI/O

basic_ifstream

basic_ofstream

basic_fstream

文字列I/O

basic_istringstream

basic_ostringstream

basic_stringstream

配列I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同期出力

basic_osyncstream (C++20)

型

streamoff

streamsize

fpos

エラーカテゴリインターフェース

iostream_category (C++11)

io_errc (C++11)

 

C形式I/O

型とオブジェクト
FILE fpos_t	stdinstdoutstderr
関数
ファイルアクセス fopen freopen fclose fflush fwide setbuf setvbuf 直接入出力 fread fwrite 非書式化入出力 fgetcgetc fgets fputcputc fputs getchar gets (C++14まで) putchar puts ungetc fgetwcgetwc fgetws fputwcputwc fputws getwchar putwchar ungetwc 書式付き入力 scanffscanfsscanf vscanfvfscanfvsscanf (C++11)(C++11)(C++11)     wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	書式付き出力 printffprintfsprintfsnprintf (C++11) vprintfvfprintfvsprintfvsnprintf (C++11)     wprintffwprintfswprintf vwprintfvfwprintfvswprintf ファイルポジショニング ftell fgetpos fseek fsetpos rewind エラーハンドリング clearerr feof ferror perror ファイル操作 remove rename tmpfile tmpnam

 

ヘッダ<cstdio>で定義
std::size_t fwrite( const void* buffer, std::size_t size, std::size_t count, std::FILE* stream );

指定された配列bufferから、最大count個のバイナリオブジェクトを出力ストリームstreamに書き込みます。オブジェクトは、各オブジェクトをunsigned charの配列として再解釈し、各オブジェクトに対してunsigned charをsize回std::fputcでストリームに書き込むかのように書き込まれます。ストリームのファイル位置指示子は、書き込まれた文字数だけ進められます。

オブジェクトがTriviallyCopyableでない場合、動作は未定義です。

エラーが発生した場合、ストリームのファイル位置指示子の結果の値は未確定です。

パラメータ

buffer	-	書き込む配列の最初のオブジェクトへのポインタ
size	-	各オブジェクトのサイズ
count	-	書き込むオブジェクトの数
stream	-	書き込む出力ファイルストリーム

戻り値

正常に書き込まれたオブジェクトの数。エラーが発生した場合は、countより少なくなることがあります。

sizeまたはcountがゼロの場合、fwriteはゼロを返し、それ以外の操作は行いません。

例

このコードを実行

#include <array>
#include <cstdio>
#include <vector>
 
int main ()
{
    // write buffer to file
    if (std::FILE* f1 = std::fopen("file.bin", "wb"))
    {
        std::array<int, 3> v = {42, -1, 7}; // underlying storage of std::array is an array
        std::fwrite(v.data(), sizeof v[0], v.size(), f1);
        std::fclose(f1);
    }
 
    // read the same data and print it to the standard output
    if (std::FILE* f2 = std::fopen("file.bin", "rb"))
    {
        std::vector<int> rbuf(10); // underlying storage of std::vector is also an array
        std::size_t sz = std::fread(rbuf.data(), sizeof rbuf[0], rbuf.size(), f2);
        std::fclose(f2);
        for (std::size_t n = 0; n < sz; ++n)
            std::printf("%d\n", rbuf[n]);
    }
}

出力

42
-1
7

関連項目

printffprintfsprintfsnprintf (C++11)	stdout、ファイルストリーム、またはバッファにフォーマットされた出力を書き込む (関数)
fputs	ファイルストリームに文字列を書き込む (関数)
fread	ファイルから読み込む (関数)
Cドキュメント (fwrite)