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

> C++ Atlas: `cppatlas.com/w/cpp/iterator/ostreambuf_iterator/failed` | Source: https://en.cppreference.com/w/cpp/iterator/ostreambuf_iterator/failed | Domain: Iterator | Standards: 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.

## Official Specification Summary (cppreference)

```cpp
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

> Note: This section is incomplete Reason: no example

---
Attribution: content from https://en.cppreference.com/w/cpp/iterator/ostreambuf_iterator/failed (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.