##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::basic_filebuf::overflow

From cppreference.com
< cpp‎ | io‎ | basic filebuf

protected: virtual int_type overflow ( int_type c = Traits::eof() ); |  |

Writes some data from the put area to the associated character sequence (to the file).

Behaves like the base class std::basic_streambuf::overflow, except that to write the data, first uses std::codecvt::out of the imbued locale to convert the characters into external (possibly multibyte) representation, stored in a temporary buffer (allocated as large as necessary), then uses file I/O to copy all fully-converted bytes into the file.

If std::codecvt::always_noconv is true, the call to std::codecvt::out may be skipped.

If the conversion fails with std::codecvt_base::error, returns Traits::eof() without attempting any output.

If the associated file is not open (is_open() == false), returns Traits::eof() before doing anything.

### [edit] Parameters

(none)

### [edit] Return value

Traits::not_eof(c) to indicate success or Traits::eof() to indicate failure.

### [edit] Example

| This section is incomplete Reason: no example

### [edit] See also

overflow [virtual] | writes characters to the associated output sequence from the put area (virtual protected member function of `std::basic_streambuf`) [edit]
underflow [virtual] | reads from the associated file (virtual protected member function) [edit]

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/io/basic_filebuf/overflow&oldid=85707"
Category:

- Todo no example