std::basic_ios<CharT,Traits>::fail
From cppreference.com
 
 
 
 
 
 C++ 
 Feature test macros (C++20)
 Concepts library (C++20)
 Metaprogramming library (C++11)
 Ranges library (C++20)
 Filesystem library (C++17)
 Concurrency support library (C++11)
 Execution control library (C++26)
Input/output library 
 
 
 
 
 
 
 
 
 
 
 
 
 Print functions (C++23)
 Buffers
(C++23)
(C++98/26*)
(C++20)
 Streams
 Abstractions
 File I/O
 String I/O
 Array I/O
(C++23)
(C++23)
(C++23)
(C++98/26*)
(C++98/26*)
(C++98/26*)
 Synchronized Output
(C++20)
 Types
 Error category interface
(C++11)
(C++11)
std::basic_ios 
 
 
 
 
 Member functions
 State functions
basic_ios::fail
 Formatting
 Miscellaneous
 Protected member functions
(C++11)
(C++11)
(C++11)
bool fail() const;
 
 
Returns true if an error has occurred on the associated stream. Specifically, returns true if badbit or failbit is set in rdstate() . 
See ios_base::iostate for the list of conditions that set failbit or badbit.
Contents
[edit] Parameters
(none)
[edit] Return value
true if an error has occurred, false otherwise.
[edit] Example
Run this code
#include <cstdlib> #include <fstream> #include <iostream> int main() { std::ifstream file("test.txt"); if (!file) // operator! is used here { std::cout << "File opening failed\n"; return EXIT_FAILURE ; } // typical C++ I/O loop uses the return value of the I/O function // as the loop controlling condition, operator bool() is used here for (int n; file >> n;) std::cout << n << ' '; std::cout << '\n'; if (file.bad()) std::cout << "I/O error while reading\n"; else if (file.eof()) std::cout << "End of file reached successfully\n"; else if (file.fail()) std::cout << "Non-integer data encountered\n"; }
[edit] See also
The following table shows the value of basic_ios accessors (good(), fail(), etc.) for all possible combinations of ios_base::iostate flags:
 ios_base::iostate flags
 
basic_ios accessors
 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