std::basic_stringbuf<CharT,Traits,Allocator>::overflow

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名需求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵器

打印函数 (C++23)

C 样式 I/O

缓冲区

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

文件 I/O

basic_ifstream

basic_ofstream

basic_fstream

字符串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

数组 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

std::basic_stringbuf

公有成员函数

basic_stringbuf::basic_stringbuf

basic_stringbuf::operator= (C++11)

basic_stringbuf::swap (C++11)

basic_stringbuf::str

basic_stringbuf::get_allocator (C++20)

basic_stringbuf::view (C++20)

保护成员函数

basic_stringbuf::underflow

basic_stringbuf::pbackfail

basic_stringbuf::overflow

basic_stringbuf::setbuf

basic_stringbuf::seekoff

basic_stringbuf::seekpos

非成员函数

swap(std::basic_stringbuf) (C++11)

仅供说明的成员函数

basic_stringbuf::init_buf_ptrs

 

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

将字符 c 附加到输出字符序列。

如果 c 是文件结束指示符 (traits::eq_int_type(c, traits::eof()) == true), 则没有字符要附加。该函数不执行任何操作并返回一个非 traits::eof() 的无指定值。

否则，如果输出序列有可用的写入位置，或者此函数可以成功地使写入位置可用，则调用 sputc(c) 并返回 c。

如果 std::stringbuf 对输出开放 ((mode & ios_base::out) != 0)，则此函数可以使写入位置可用：在这种情况下，它会重新分配（或最初分配）足够大的缓冲区以容纳整个当前缓冲区加上至少一个字符。如果 std::stringbuf 也对输入开放 ((mode & ios_base::in) != 0)，则 overflow 还会通过将 egptr() 指向新的写入位置之后的点来增加获取区域的大小。

参数

c

-

要存储在放置区域中的字符

返回值

Traits::eof() 表示失败，c 表示字符 c 成功附加，或者表示非 Traits::eof() 的某些值，如果使用 Traits::eof() 作为参数调用。

注释

此函数不同于典型的 overflow()，后者将缓冲区的内容移动到关联的字符序列，因为对于 std::basic_stringbuf，缓冲区和关联的序列是同一个。

示例

在用于执行此示例的实现（例如 GCC-4.9）中，overflow() 将放置区域过度分配到 512 字节：对 str() 的调用只会返回四个已初始化的字节，但对 sputc() 的接下来的 508 次调用将不需要新的 overflow() 调用。

运行此代码

#include <sstream>
#include <iostream>
 
struct mybuf : std::stringbuf
{
    mybuf(const std::string& new_str,
          std::ios_base::openmode which = std::ios_base::in | std::ios_base::out)
        : std::stringbuf(new_str, which) {}
 
    int_type overflow(int_type c = EOF) override
    {
        std::cout << "stringbuf::overflow('" << char(c) << "') called\n"
                  << "Before: size of get area: " << egptr() - eback() << '\n'
                  << "        size of put area: " << epptr() - pbase() << '\n';
 
        int_type ret = std::stringbuf::overflow(c);
 
        std::cout << "After : size of get area: " << egptr() - eback() << '\n'
                  << "        size of put area: " << epptr() - pbase() << '\n';
 
        return ret;
    }
};
 
int main()
{
    std::cout << "read-write stream:\n";
    mybuf sbuf("   "); // read-write stream
    std::iostream stream(&sbuf);
    stream << 1234;
    std::cout << sbuf.str() << '\n';
 
    std::cout << "\nread-only stream:\n";
    mybuf ro_buf("   ", std::ios_base::in); // read-only stream
    std::iostream ro_stream(&ro_buf);
    ro_stream << 1234;
 
    std::cout << "\nwrite-only stream:\n";
    mybuf wr_buf("   ", std::ios_base::out); // write-only stream
    std::iostream wr_stream(&wr_buf);
    wr_stream << 1234;
}

可能的输出

read-write stream:
stringbuf::overflow('4') called
Before: size of get area: 3
        size of put area: 3
After : size of get area: 4
        size of put area: 512
1234
 
read-only stream:
stringbuf::overflow('1') called
Before: size of get area: 3
        size of put area: 0
After : size of get area: 3
        size of put area: 0
 
write-only stream:
stringbuf::overflow('4') called
Before: size of get area: 0
        size of put area: 3
After : size of get area: 0
        size of put area: 512

缺陷报告

以下行为更改缺陷报告被追溯应用于先前发布的 C++ 标准。

DR	应用于	已发布的行为	正确行为
LWG 169	C++98	重新分配的缓冲区只能容纳一个额外字符	允许更多额外字符
LWG 432	C++98	overflow 将 epptr() 移动到指向新的 写入位置，如果 std::stringbuf 对输入开放	它不会移动

另请参阅

overflow [virtual]	从放置区域写入字符到关联的输出序列 (std::basic_streambuf<CharT,Traits> 的虚拟受保护成员函数)
underflow [virtual]	返回输入序列中可用的下一个字符 (虚拟受保护成员函数)