std::ostreambuf_iterator<CharT,Traits>:: failed

From cppreference.com
Iterator library
Iterator concepts
Iterator primitives
Algorithm concepts and utilities
Indirect callable concepts
Common algorithm requirements
(C++20)
(C++20)
(C++20)
Utilities
(C++20)
Iterator adaptors
Range access
(C++11) (C++14)
(C++14) (C++14)
(C++11) (C++14)
(C++14) (C++14)
(C++17) (C++20)
(C++17)
(C++17)
bool failed ( ) const throw ( ) ;
(until C++11)
bool failed ( ) const noexcept ;
(since C++11)

Returns true if the iterator encountered the end-of-file condition, that is, if an earlier call to std::basic_streambuf::sputc (made by operator= ) returned Traits :: eof .

Parameters

(none)

Return value

true if this iterator has encountered the end-of-file condition on output, false otherwise.

Example