std::basic_ios<CharT,Traits>::fail

 

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_ios

メンバ関数

basic_ios::basic_ios

basic_ios::~basic_ios

状態関数

basic_ios::good

basic_ios::eof

basic_ios::fail

basic_ios::bad

basic_ios::operator!

basic_ios::operator bool

basic_ios::rdstate

basic_ios::setstate

basic_ios::clear

書式

basic_ios::copyfmt

basic_ios::fill

その他

basic_ios::exceptions

basic_ios::imbue

basic_ios::rdbuf

basic_ios::tie

basic_ios::narrow

basic_ios::widen

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

basic_ios::init

basic_ios::move

basic_ios::swap

basic_ios::set_rdbuf

 

bool fail()const;

紐付けられたストリームにエラーが発生していれば true を返します。 具体的には、 rdstate() に badbit または failbit がセットされていれば true を返します。

failbit または badbit がセットされる状況の一覧は ios_base::iostate を参照してください。

引数

(なし)

戻り値

エラーが発生していれば true、そうでなければ false。

例

Run this code

#include <iostream>#include <fstream>#include <cstdlib>int main(){std::ifstream file("test.txt");if(!file)// operator! is used here{std::cout<<"File opening failed\n";returnEXIT_FAILURE;}   // typical C++ I/O loop uses the return value of the I/O function// as the loop controlling condition, operator bool() is used herefor(int n; file >> n;){std::cout<< n <<' ';}std::cout<<'\n';   if(file.bad())std::cout<<"I/O error while reading\n";elseif(file.eof())std::cout<<"End of file reached successfully\n";elseif(file.fail())std::cout<<"Non-integer data encountered\n";}

関連項目

以下の表は ios_base::iostate フラグのすべての有り得る組み合わせに対する basic_ios のアクセサ (good()、 fail() など) の値を示します。

ios_base::iostate のフラグ			basic_ios のアクセサ
eofbit	failbit	badbit	good()	fail()	bad()	eof()	operator bool	operator!
false	false	false	true	false	false	false	true	false
false	false	true	false	true	true	false	false	true
false	true	false	false	true	false	false	false	true
false	true	true	false	true	true	false	false	true
true	false	false	false	false	false	true	true	false
true	false	true	false	true	true	true	false	true
true	true	false	false	true	false	true	false	true
true	true	true	false	true	true	true	false	true

ferror

ファイルのエラーを調べます (関数)