C++

参考

C 库
- <cassert> (assert.h)
- <cctype> (ctype.h)
- <cerrno> (errno.h)
- C++11
  <cfenv> (fenv.h)
- <cfloat> (float.h)
- C++11
  <cinttypes> (inttypes.h)
- <ciso646> (iso646.h)
- <climits> (limits.h)
- <clocale> (locale.h)
- <cmath> (math.h)
- <csetjmp> (setjmp.h)
- <csignal> (signal.h)
- <cstdarg> (stdarg.h)
- C++11
  <cstdbool> (stdbool.h)
- <cstddef> (stddef.h)
- C++11
  <cstdint> (stdint.h)
- <cstdio> (stdio.h)
- <cstdlib> (stdlib.h)
- <cstring> (string.h)
- C++11
  <ctgmath> (tgmath.h)
- <ctime> (time.h)
- C++11
  <cuchar> (uchar.h)
- <cwchar> (wchar.h)
- <cwctype> (wctype.h)
容器
- C++11
  <array>
- <deque>
- C++11
  <forward_list>
- <list>
- <map>
- <queue>
- <set>
- <stack>
- C++11
  <unordered_map>
- C++11
  <unordered_set>
- <vector>
输入/输出
- <fstream>
- <iomanip>
- <ios>
- <iosfwd>
- <iostream>
- <istream>
- <ostream>
- <sstream>
- <streambuf>
多线程
- C++11
  <atomic>
- C++11
  <condition_variable>
- C++11
  <future>
- C++11
  <mutex>
- C++11
  <thread>
其他
- <algorithm>
- <bitset>
- C++11
  <chrono>
- C++11
  <codecvt>
- <complex>
- <exception>
- <functional>
- C++11
  <initializer_list>
- <iterator>
- <limits>
- <locale>
- <memory>
- <new>
- <numeric>
- C++11
  <random>
- C++11
  <ratio>
- C++11
  <regex>
- <stdexcept>
- <string>
- C++11
  <system_error>
- C++11
  <tuple>
- C++11
  <type_traits>
- C++11
  <typeindex>
- <typeinfo>
- <utility>
- <valarray>

<streambuf>

basic_streambuf

参考
<streambuf>
basic_streambuf

类模板

std::basic_streambuf

template <class charT, class traits = char_traits<charT> >  class basic_streambuf;

面向流的基缓冲类

basic_streambuf
basic_filebufbasic_stringbuf

此模板被设计为所有流缓冲类的基虚拟类。

一个流缓冲是负责执行其关联的流对象读写操作的对象：流将所有此类操作委托给其关联的流缓冲对象，该对象是流与其受控输入输出序列之间的中介。

所有流对象，无论是否缓冲，都有一个关联的流缓冲：然后某些流缓冲类型可以设置为使用中间缓冲或不使用。

流缓冲对象至少在内部维护：

一个locale对象，用于进行依赖于区域设置的操作。
一组内部指针，用于维护输入缓冲：eback、gptr、egptr。
一组内部指针，用于维护输出缓冲：pbase、pptr、epptr。

内部，basic_streambuf类是一个被详细说明的基类，旨在为所有派生类提供统一的公共接口：这些公共函数调用受保护的虚拟成员，派生类可以重写这些成员来实现特定行为。这些重写的虚拟函数通过一组受保护的函数（见下文）访问basic_streambuf类的内部。

模板参数

charT: 字符类型。
这应是一个非数组的 POD 类型。
别名为成员类型basic_streambuf::char_type。
特性 (traits): 字符特性类，它定义了流对象使用的字符的基本属性（参见char_traits）。
traits::char_type 应当与 charT 相同。
别名为成员类型basic_streambuf::traits_type。

sub_match for string literals (class)

streambuf: 流的基缓冲类 (类)

wstreambuf: 面向流的基缓冲类（宽）(class)

这些实例化在<streambuf>中声明，而<iostream>通过引用包含了它。

成员类型

成员类型	定义	说明
`char_type`	第一个模板参数（`charT`）
`traits_type`	第二个模板参数（`traits`）	默认为：`char_traits<charT>`
`int_type`	`traits_type::int_type`
`pos_type`	`traits_type::pos_type`	通常与 `streampos` 相同
`off_type`	`traits_type::off_type`	通常与 `streamoff` 相同

公开成员函数

所有流缓冲的通用功能通过以下公共成员函数提供：

（构造函数）: 构造对象（公开成员函数）

(析构函数): 销毁对象（公开成员函数）

区域设置:

pubimbue: 注入 locale （公开成员函数）

getloc: 获取当前 locale （公开成员函数）

缓冲区管理和定位:

pubsetbuf: 设置缓冲区数组 (公有成员函数)

pubseekoff: 将内部位置指针设置为相对位置 (公有成员函数)

pubseekpos: 将内部位置指针设置为绝对位置 (公有成员函数)

pubsync: 同步流缓冲区 (公有成员函数)

输入函数 (get):

in_avail: 获取可读的字符数 (公开成员函数)

snextc: 前进到下一个位置并获取字符 (公有成员函数)

sbumpc: 获取当前字符并前进到下一个位置 (公有成员函数)

sgetc: 获取当前字符 (公有成员函数)

sgetn: 获取字符序列 (公有成员函数)

sputbackc: 放回字符 (公共成员函数)

sungetc: 后退当前位置 (公有成员函数)

输出函数 (put):

sputc: 放置字符并前进到下一位置 (公开成员函数)

sputn: 放置字符序列 (公有成员函数)

受保护成员函数

公共函数不直接对受控输入输出序列执行操作，而是主要依赖于一组内部指针可访问的两个数组：

	beginning (起始指针)	current position (get/put指针)	end (结束指针)
Input sequence	`eback`	`gptr`	`egptr`
Output sequence	`pbase`	`pptr`	`epptr`

以下受保护的成员函数提供对这些指针的访问：

输入序列 (get):

eback: 指向输入序列起始的指针 (保护成员函数)

gptr: 指向输入序列当前位置的指针 (保护成员函数)

egptr: 指向输入序列结尾的指针 (保护成员函数)

gbump: 前进获取指针 (受保护成员函数)

setg: 设置输入序列指针 (保护成员函数)

输出序列 (put):

pbase: 指向输出序列起始的指针 (保护成员函数)

pptr: 指向输出序列当前位置的指针 (保护成员函数)

epptr: 指向输出序列结尾的指针 (保护成员函数)

pbump: 增加放置指针 (保护成员函数)

setp: 设置输出序列指针 (保护成员函数)

复制:

operator=: 流缓冲区赋值 (public member function)

swap: 交换流缓冲区 (公有成员函数)

虚保护成员函数

每个streambuf-派生类应定义成员，以使其指针对于其自身的受控序列类型保持有效；修改指针值、重新分配序列本身，并执行所有必要的与关联字符序列的同步。

通过此设计，涉及读取和写入特定关联字符序列以及管理受控序列的核心功能是通过虚拟函数提供的，这些函数由派生类根据需要进行重写：

区域设置:

imbue: 注入区域设置 (保护虚成员函数)