Namespaces
Variants
Views
Actions

std::basic_filebuf::overflow

From cppreference.com
< cpp‎ | io‎ | basic filebuf
Revision as of 17:46, 3 July 2013 by SuperBoi45 (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
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 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 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.

Contents

[edit] Parameters

(none)

[edit] Return value

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

[edit] Example

[edit] See also

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