std::basic_filebuf

 

C++

言語

標準ライブラリヘッダ

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

名前付き要件

言語サポートライブラリ

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

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ(C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

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

正規表現ライブラリ(C++11)

アトミック操作ライブラリ(C++11)

スレッドサポートライブラリ(C++11)

技術仕様書

 

入出力ライブラリ

入出力マニピュレータ

Cスタイルの入出力

バッファ

basic_streambuf

basic_filebuf

basic_stringbuf

strstreambuf (C++98で非推奨)

basic_syncbuf (C++20)

ストリーム

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

ファイル入出力

basic_ifstream

basic_ofstream

basic_fstream

文字列入出力

basic_istringstream

basic_ostringstream

basic_stringstream

配列入出力

istrstream (C++98で非推奨)

ostrstream (C++98で非推奨)

strstream (C++98で非推奨)

同期化出力

basic_osyncstream (C++20)

型

streamoff

streamsize

fpos

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

iostream_category (C++11)

io_errc (C++11)

 

std::basic_filebuf

パブリックメンバ関数

basic_filebuf::basic_filebuf

basic_filebuf::~basic_filebuf

basic_filebuf::operator= (C++11)

basic_filebuf::swap (C++11)

basic_filebuf::is_open

basic_filebuf::open

basic_filebuf::close

プロテクテッドメンバ関数

basic_filebuf::showmanyc

basic_filebuf::underflow

basic_filebuf::uflow

basic_filebuf::pbackfail

basic_filebuf::overflow

basic_filebuf::setbuf

basic_filebuf::seekoff

basic_filebuf::seekpos

basic_filebuf::sync

basic_filebuf::imbue

非メンバ関数

swap(std::basic_filebuf) (C++11)

 

ヘッダ <fstream> で定義
template<     class CharT,     class Traits =std::char_traits<CharT> >class basic_filebuf :publicstd::basic_streambuf<CharT, Traits>

std::basic_filebuf は紐付けられている文字シーケンスがファイルである std::basic_streambuf です。 入力シーケンスと出力シーケンスの両方が同じファイルに紐付けられ、両方の操作に対して結合されたファイル位置が維持管理されます。

関数 underflow() および overflow()、sync() はファイルとバッファの get、put 領域との間で実際の入出力を行います。 CharT が char でないときは、ほとんどの処理系はファイルにマルチバイト文字を格納し、ワイド文字とマルチバイト文字に変換を行うために std::codecvt ファセットが使用されます。

一般的な文字型に対する2つの特殊化が定義されます。

ヘッダ <streambuf> で定義
型	定義
filebuf	basic_filebuf<char>
wfilebuf	basic_filebuf<wchar_t>

メンバ型

メンバ型	定義
char_type	CharT
traits_type	Traits。 Traits::char_type が CharT でない場合、プログラムは ill-formed です
int_type	Traits::int_type
pos_type	std::fpos<Traits::state_type> であることが要求される Traits::pos_type
off_type	Traits::off_type

メンバ関数

パブリックメンバ関数
コンストラクタ	basic_filebuf オブジェクトを構築します (パブリックメンバ関数)
operator= (C++11)	basic_filebuf オブジェクトを代入します (パブリックメンバ関数)
swap (C++11)	2つの basic_filebuf オブジェクトを入れ替えます (パブリックメンバ関数)
デストラクタ [仮想]	basic_filebuf オブジェクトを破棄し、開いている場合はファイルを閉じます (仮想パブリックメンバ関数)
is_open	紐付けられているファイルが開いているかどうか調べます (パブリックメンバ関数)
open	ファイルを開き、それを文字シーケンスとして紐付けます (パブリックメンバ関数)
close	put 領域のバッファをフラッシュし、紐付けられているファイルを閉じます (パブリックメンバ関数)
プロテクテッドメンバ関数
showmanyc [仮想]	ファイルからの入力用に利用可能な文字数を任意で提供します (仮想プロテクテッドメンバ関数)
underflow [仮想]	紐付けられているファイルから読み込みます (仮想プロテクテッドメンバ関数)
uflow [仮想]	紐付けられているファイルから読み込み、 get 領域の次ポインタを進めます (仮想プロテクテッドメンバ関数)
pbackfail [仮想]	文字を unget するために入力シーケンスを後退させます。 紐付けられているファイルには影響を与えません (仮想プロテクテッドメンバ関数)
overflow [仮想]	put 領域から紐付けられているファイルに文字を書き込みます (仮想プロテクテッドメンバ関数)
setbuf [仮想]	ユーザ提供のバッファを提供し、またはこの filebuf をバッファなしにします (仮想プロテクテッドメンバ関数)
seekoff [仮想]	相対位置を使用してファイル位置を再設定します (仮想プロテクテッドメンバ関数)
seekpos [仮想]	絶対位置を使用してファイル位置を再設定します (仮想プロテクテッドメンバ関数)
sync [仮想]	put 領域から紐付けられているファイルに文字を書き込みます (仮想プロテクテッドメンバ関数)
imbue [仮想]	紐付けられているロケールを変更します (仮想プロテクテッドメンバ関数)

非メンバ関数

std::swap(std::basic_filebuf) (C++11)

std::swap アルゴリズムの特殊化 (関数テンプレート)

std::basic_streambuf から継承

メンバ型

メンバ型	定義
char_type	CharT
traits_type	Traits。 Traits::char_type が CharT でない場合、プログラムは ill-formed です
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type

メンバ関数

デストラクタ [仮想]	basic_streambuf オブジェクトを破棄します (std::basic_streambuf<CharT,Traits>の仮想パブリックメンバ関数)
ロケール
pubimbue	imbue() を呼びます (std::basic_streambuf<CharT,Traits>のパブリックメンバ関数)
getloc	紐付けられているロケールのコピーを取得します (std::basic_streambuf<CharT,Traits>のパブリックメンバ関数)
位置設定
pubsetbuf	setbuf() を呼びます (std::basic_streambuf<CharT,Traits>のパブリックメンバ関数)
pubseekoff	seekoff() を呼びます (std::basic_streambuf<CharT,Traits>のパブリックメンバ関数)
pubseekpos	seekpos() を呼びます (std::basic_streambuf<CharT,Traits>のパブリックメンバ関数)
pubsync	sync() を呼びます (std::basic_streambuf<CharT,Traits>のパブリックメンバ関数)
get 領域
in_avail	get 領域内の直ちに利用可能な文字数を取得します (std::basic_streambuf<CharT,Traits>のパブリックメンバ関数)
snextc	入力シーケンスを進めて、その後、進めずに文字をひとつ読み込みます (std::basic_streambuf<CharT,Traits>のパブリックメンバ関数)
sbumpc	入力シーケンスから文字をひとつ読み込み、シーケンスを進めます (std::basic_streambuf<CharT,Traits>のパブリックメンバ関数)
stossc (C++98で非推奨)(C++17で削除)	sbumpc() を呼んだかのように入力シーケンスを進めて、その結果を破棄します (パブリックメンバ関数)
sgetc	シーケンスを進めずに入力シーケンスから文字をひとつ読み込みます (std::basic_streambuf<CharT,Traits>のパブリックメンバ関数)
sgetn	xsgetn() を呼びます (std::basic_streambuf<CharT,Traits>のパブリックメンバ関数)
put 領域
sputc	文字をひとつ put 領域に書き込み、次ポインタを進めます (std::basic_streambuf<CharT,Traits>のパブリックメンバ関数)
sputn	xsputn() を呼びます (std::basic_streambuf<CharT,Traits>のパブリックメンバ関数)
putback
sputbackc	入力シーケンスに文字をひとつ戻します (std::basic_streambuf<CharT,Traits>のパブリックメンバ関数)
sungetc	入力シーケンスの次ポインタを1つ前に移動させます (std::basic_streambuf<CharT,Traits>のパブリックメンバ関数)

プロテクテッドメンバ関数

コンストラクタ	basic_streambuf オブジェクトを構築します (プロテクテッドメンバ関数)
operator= (C++11)	basic_streambuf オブジェクトを置き換えます (プロテクテッドメンバ関数)
swap (C++11)	2つの basic_streambuf オブジェクトを入れ替えます (プロテクテッドメンバ関数)
ロケール
imbue [仮想]	紐付けられているロケールを変更します (std::basic_streambuf<CharT,Traits>の仮想プロテクテッドメンバ関数)
位置設定
setbuf [仮想]	可能であれば、バッファをユーザ定義の配列に置き換えます (std::basic_streambuf<CharT,Traits>の仮想プロテクテッドメンバ関数)
seekoff [仮想]	入力シーケンス、出力シーケンス、またはその両方の次ポインタの位置を相対位置を使用して再設定します (std::basic_streambuf<CharT,Traits>の仮想プロテクテッドメンバ関数)
seekpos [仮想]	入力シーケンス、出力シーケンス、またはその両方の次ポインタの位置を絶対位置を使用して再設定します (std::basic_streambuf<CharT,Traits>の仮想プロテクテッドメンバ関数)
sync [仮想]	バッファを紐付けられている文字シーケンスと同期します (std::basic_streambuf<CharT,Traits>の仮想プロテクテッドメンバ関数)
get 領域
showmanyc [仮想]	紐付けられている入力シーケンス内の入力のために利用可能な文字数 (もし判れば) を取得します (std::basic_streambuf<CharT,Traits>の仮想プロテクテッドメンバ関数)
underflow [仮想]	紐付けられている入力シーケンスから get 領域に文字を読み込みます (std::basic_streambuf<CharT,Traits>の仮想プロテクテッドメンバ関数)
uflow [仮想]	紐付けられている入力シーケンスから get 領域に文字を読み込み、次ポインタを進めます (std::basic_streambuf<CharT,Traits>の仮想プロテクテッドメンバ関数)
xsgetn [仮想]	入力シーケンスから複数の文字を読み込みます (std::basic_streambuf<CharT,Traits>の仮想プロテクテッドメンバ関数)
ebackgptregptr	get 領域の先頭、現在の文字、終端へのポインタを返します (プロテクテッドメンバ関数)
gbump	入力シーケンスの次ポインタを進めます (プロテクテッドメンバ関数)
setg	入力シーケンスの先頭、次、終端ポインタの位置を再設定します (プロテクテッドメンバ関数)
put 領域
xsputn [仮想]	出力シーケンスに複数の文字を出力します (std::basic_streambuf<CharT,Traits>の仮想プロテクテッドメンバ関数)
overflow [仮想]	put 領域から紐付けられている出力シーケンスに文字を書き込みます (std::basic_streambuf<CharT,Traits>の仮想プロテクテッドメンバ関数)
pbasepptrepptr	put 領域の先頭、現在の文字、終端へのポインタを返します (プロテクテッドメンバ関数)
pbump	出力シーケンスの次ポインタを進めます (プロテクテッドメンバ関数)
setp	出力シーケンスの先頭、次、終端ポインタの位置を再設定します (プロテクテッドメンバ関数)
putback
pbackfail [仮想]	入力シーケンスに文字を戻します。 入力シーケンスを変更する可能性があります (std::basic_streambuf<CharT,Traits>の仮想プロテクテッドメンバ関数)

関連項目

FILE	C の入出力ストリームを制御するために必要なすべての情報を保持できるオブジェクト型 (typedef)