| CARVIEW |
Select Language
HTTP/1.1 301 Moved Permanently
Server: nginx
Date: Thu, 24 Jul 2025 03:32:15 GMT
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Location: /reference/fstream/basic_filebuf/overflow/
HTTP/1.1 200 OK
Server: nginx
Date: Thu, 24 Jul 2025 03:32:16 GMT
Content-Type: text/html; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
ETag: W/"79ff-7EV8AtLBJnJ4kHI/IXQ+cKJWnNE"
Content-Encoding: gzip
Writes the contents of the intermediate output buffer to the associated file, followed by c (unless c is traits_type::eof).
The function uses codecvt::out to convert the characters out with the proper facet. It then updates the pointers that define the intermediate output buffer (pptr, epptr and pbase) in such a way that the characters written to the file are not part of it, and -possibly- writing positions are made available at the put pointer (pptr).
If the function cannot write the characters, it returns the end-of-file value (
This function is called by public member functions of its base class such as sputc to put a character when there are no writing positions available at the put pointer (pptr).
This member function overrides the inherited virtual member basic_streambuf::overflow.
Otherwise, it returns the end-of-file value (
Member type int_type is an integral type able to represent any character value or the special end-of-file value.
Concurrent access to the same file stream buffer object may introduce data races.
Reference
C library:
- <cassert> (assert.h)
- <cctype> (ctype.h)
- <cerrno> (errno.h)
-
<cfenv> (fenv.h)C++11
- <cfloat> (float.h)
-
<cinttypes> (inttypes.h)C++11
- <ciso646> (iso646.h)
- <climits> (limits.h)
- <clocale> (locale.h)
- <cmath> (math.h)
- <csetjmp> (setjmp.h)
- <csignal> (signal.h)
- <cstdarg> (stdarg.h)
-
<cstdbool> (stdbool.h)C++11
- <cstddef> (stddef.h)
-
<cstdint> (stdint.h)C++11
- <cstdio> (stdio.h)
- <cstdlib> (stdlib.h)
- <cstring> (string.h)
-
<ctgmath> (tgmath.h)C++11
- <ctime> (time.h)
-
<cuchar> (uchar.h)C++11
- <cwchar> (wchar.h)
- <cwctype> (wctype.h)
Containers:
-
<array>C++11
- <deque>
-
<forward_list>C++11
- <list>
- <map>
- <queue>
- <set>
- <stack>
-
<unordered_map>C++11
-
<unordered_set>C++11
- <vector>
-
Input/Output:
Multi-threading:
-
<atomic>C++11
-
<condition_variable>C++11
-
<future>C++11
-
<mutex>C++11
-
<thread>C++11
-
Other:
- <algorithm>
- <bitset>
-
<chrono>C++11
-
<codecvt>C++11
- <complex>
- <exception>
- <functional>
-
<initializer_list>C++11
- <iterator>
- <limits>
- <locale>
- <memory>
- <new>
- <numeric>
-
<random>C++11
-
<ratio>C++11
-
<regex>C++11
- <stdexcept>
- <string>
-
<system_error>C++11
-
<tuple>C++11
-
<type_traits>C++11
-
<typeindex>C++11
- <typeinfo>
- <utility>
- <valarray>
<fstream>
class templates
classes
basic_filebuf
- basic_filebuf::~basic_filebuf
- basic_filebuf::basic_filebuf
public members
protected virtual members
non-member overloads
-
swap (basic_filebuf)C++11
-
- Reference
- <fstream>
- basic_filebuf
- overflow
protected virtual member function
<fstream>
std::basic_filebuf::overflow
int_type overflow (int_type c = traits_type::eof());
Put character on overflow
The function uses codecvt::out to convert the characters out with the proper facet. It then updates the pointers that define the intermediate output buffer (pptr, epptr and pbase) in such a way that the characters written to the file are not part of it, and -possibly- writing positions are made available at the put pointer (pptr).
If the function cannot write the characters, it returns the end-of-file value (
traits_type::eof()) to signal failure.This function is called by public member functions of its base class such as sputc to put a character when there are no writing positions available at the put pointer (pptr).
This member function overrides the inherited virtual member basic_streambuf::overflow.
Parameters
- c
- Character to be put.
If this is the end-of-file value (traits_type::eof()), no character is put, but the other effects of calling this function are attempted.
Member type int_type is an integral type able to represent any character value or the special end-of-file value.
Return Value
In case of success, the character put is returned, converted to a value of type int_type using member traits_type::to_int_type.Otherwise, it returns the end-of-file value (
traits_type::eof()) either if called with this value as argument c or to signal a failure (some implementations may throw an exception instead).Member type int_type is an integral type able to represent any character value or the special end-of-file value.
Data races
Modifies the basic_filebuf object.Concurrent access to the same file stream buffer object may introduce data races.
Exception safety
Basic guarantee: if an exception is thrown, the file stream buffer is in a valid state.See also
- basic_streambuf::overflow
- Put character on overflow (protected virtual member function)
- basic_streambuf::sputc
- Put character and advance to next position (public member function)
Home page | Privacy policy
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us