C++ å‚考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支æŒæƒ…况表
- 独立与宿主实现
- C++ è¯è¨€
- C++ 关键è¯
- 预处ç†å™¨
- C++ æ ‡å‡†åº“å¤´æ–‡ä»¶
- å…·åè¦æ±‚
- 功能特性测试 (C++20)
- 工具库
- 类型支æŒï¼ˆåŸºæœ¬ç±»åž‹ã€RTTIã€ç±»åž‹ç‰¹æ€§ï¼‰
- 概念库 (C++20)
- 错误处ç†
- 动æ€å†…å˜ç®¡ç†
- 日期和时间工具
- å—符串库
- 容器库
- è¿ä»£å™¨åº“
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- C é£Žæ ¼æ–‡ä»¶è¾“å…¥/输出
- std::basic_streambuf
- std::basic_filebuf
- std::basic_stringbuf
- 输入/输出æ“纵符
- std::strstreambuf
- std::basic_syncbuf
- std::basic_ios
- std::basic_istream
- std::ios_base
- std::basic_osyncstream
- std::basic_ostream
- std::basic_iostream
- std::basic_ifstream
- std::basic_ofstream
- std::basic_fstream
- std::basic_istringstream
- std::basic_ostringstream
- std::basic_stringstream
- std::istrstream
- std::ostrstream
- std::strstream
- std::streamoff
- std::streamsize
- std::fpos
- std::iostream_category
- std::io_errc
- std::cin, std::wcin
- std::cout, std::wcout
- std::cerr, std::wcerr
- std::clog, std::wclog
- 注释
- 文件系统库
- 本地化库
- æ£åˆ™è¡¨è¾¾å¼åº“
- 原åæ“作库
- 线程支æŒåº“
- 实验性 C++ 特性
- 有用的资æº
- 索引
- std 符å·ç´¢å¼•
- åç¨‹æ”¯æŒ (C++20)
- C++ 关键è¯
ä½ç½®ï¼šé¦–页 > C++ å‚考手册 >输入/输出库 > std::basic_stringbuf
std::basic_stringbuf
  class CharT,
  class Traits = std::char_traits<CharT>,
  class Allocator = std::allocator<CharT>
std::basic_stringbuf 是关è”å—符åºåˆ—为内å˜å¸¸é©»çš„ä»»æ„å—符åºåˆ—çš„ std::basic_streambuf 。能从 std::basic_string 的实例åˆå§‹åŒ–它，或将它åšæˆè¯¥ç±»çš„实例。
std::basic_stringbuf 的典型实现ä¿æœ‰ä¸€ä¸ª std::basic_string 类型对象，或ç‰ä»·çš„å¯ä¼¸ç¼©åºåˆ—容器作为数æ®æˆå‘˜ï¼Œå¹¶å°†å®ƒåŒæ—¶ç”¨ä½œå—控制å—符åºåˆ—（为 std::basic_streambuf çš„å…个指针所指å‘的数组）和关è”å—符åºåˆ—（所有输入æ“作的å—符æºå’Œè¾“出æ“ä½œçš„ç›®æ ‡ï¼‰ã€‚
å¦å¤–，典型的实现ä¿æœ‰ä¸€ä¸ª std::ios_base::openmode 类型的数æ®æˆå‘˜ï¼Œä»¥æŒ‡ç¤ºæµçš„状æ€ï¼ˆåªè¯»ã€åªå†™ã€è¯»å†™ã€å°¾ç«¯å†™ç‰ï¼‰ã€‚
|
è‹¥ overflow() 使用过分é…ç–略，则å¯å˜å‚¨å¦å¤–的高水ä½æŒ‡é’ˆï¼Œä»¥è·Ÿè¸ªæœ€åŽåˆå§‹åŒ–çš„å—符。 |
(C++11 èµ·) |
亦æ供二个对常用å—符类型的特化：
| 定义于头文件
<sstream> | |
| Â | |
| 类型 | 定义 |
stringbuf
|
basic_stringbuf<char> |
wstringbuf
|
basic_stringbuf<wchar_t> |
æˆå‘˜ç±»åž‹
| Â | |
| æˆå‘˜ç±»åž‹ | 定义 |
char_type
|
CharT |
traits_type
|
Traits ；若 Traits::char_type ä¸æ˜¯ CharT 则程åºä¸ºè°¬æž„。 |
int_type
|
Traits::int_type |
pos_type
|
Traits::pos_type |
off_type
|
Traits::off_type |
allocator_type (C++11 èµ·)
|
Allocator |
æˆå‘˜å‡½æ•°
公开æˆå‘˜å‡½æ•° | |
| æž„é€ ä¸€ä¸ª basic_stringbuf 对象 (公开æˆå‘˜å‡½æ•°) | |
| (C++11) |
赋值 basic_stringbuf 对象 (公开æˆå‘˜å‡½æ•°) |
| (C++11) |
交æ¢äºŒä¸ª basic_stringbuf 对象 (公开æˆå‘˜å‡½æ•°) |
| (æžæž„函数) [虚] (éšå¼å£°æ˜Ž) |
æžæž„ basic_stringbuf 对象和其所ä¿æœ‰çš„ string (虚公开æˆå‘˜å‡½æ•°) |
| 替æ¢æˆ–获得关è”å—符串的副本 (公开æˆå‘˜å‡½æ•°) | |
| (C++20) |
获得与内部 basic_string å…³è”的分é…器的副本 (公开æˆå‘˜å‡½æ•°) |
| (C++20) |
获得底层å—符åºåˆ—上的视图 (公开æˆå‘˜å‡½æ•°) |
å—ä¿æŠ¤æˆå‘˜å‡½æ•° | |
| [虚] |
返回输入åºåˆ—ä¸å¯ç”¨çš„下一å—符 (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
回放å—符到输出åºåˆ—ä¸ (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
åŽé™„å—符到输出åºåˆ— (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
试图以数组替æ¢å—控å—符åºåˆ— (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
用相对寻å€ï¼Œé‡å®šä½è¾“å…¥åºåˆ—ã€è¾“出åºåˆ—或两者ä¸çš„下一ä½ç½®æŒ‡é’ˆ (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
用ç»å¯¹å¯»å€ï¼Œé‡å®šä½è¾“å…¥åºåˆ—ã€è¾“出åºåˆ—或两者ä¸çš„下一ä½ç½®æŒ‡é’ˆ (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
éžæˆå‘˜å‡½æ•°
| 特化 std::swap 算法 (函数模æ¿) |
继承自 std::basic_streambuf
æˆå‘˜ç±»åž‹
| Â | |
| æˆå‘˜ç±»åž‹ | 定义 |
char_type
|
CharT |
traits_type
|
Traits ；若 Traits::char_type ä¸æ˜¯ CharT 则程åºä¸ºè°¬æž„。 |
int_type
|
Traits::int_type |
pos_type
|
Traits::pos_type |
off_type
|
Traits::off_type |
æˆå‘˜å‡½æ•°
| [虚] |
æžæž„ basic_streambuf 对象 ( std::basic_streambuf<CharT,Traits> 的虚公开æˆå‘˜å‡½æ•°) |
本地环境 | |
| 调用 imbue() ( std::basic_streambuf<CharT,Traits> 的公开æˆå‘˜å‡½æ•°) | |
| 获得相关本地环境的副本 ( std::basic_streambuf<CharT,Traits> 的公开æˆå‘˜å‡½æ•°) | |
å¯»ä½ | |
| 调用 setbuf() ( std::basic_streambuf<CharT,Traits> 的公开æˆå‘˜å‡½æ•°) | |
| 调用 seekoff() ( std::basic_streambuf<CharT,Traits> 的公开æˆå‘˜å‡½æ•°) | |
| 调用 seekpos() ( std::basic_streambuf<CharT,Traits> 的公开æˆå‘˜å‡½æ•°) | |
| 调用 sync() ( std::basic_streambuf<CharT,Traits> 的公开æˆå‘˜å‡½æ•°) | |
获å–区 | |
| 获得获å–区ä¸ç«‹å³å¯ç”¨çš„å—符数 ( std::basic_streambuf<CharT,Traits> 的公开æˆå‘˜å‡½æ•°) | |
| 令输入åºåˆ—å‰è¿›ï¼Œè¯»å–一个å—符而ä¸å†æ¬¡å‰è¿› ( std::basic_streambuf<CharT,Traits> 的公开æˆå‘˜å‡½æ•°) | |
| 从输入åºåˆ—读å–一个å—符并令åºåˆ—å‰è¿› ( std::basic_streambuf<CharT,Traits> 的公开æˆå‘˜å‡½æ•°) | |
| stossc (C++98 ä¸å¼ƒç”¨)(C++17 ä¸ç§»é™¤) |
令输入åºåˆ—å‰è¿›ï¼Œå¦‚åŒé€šè¿‡è°ƒç”¨ sbumpc() 并èˆå¼ƒç»“æžœ (公开æˆå‘˜å‡½æ•°) |
| 从输入åºåˆ—读å–一个å—符，而ä¸ä»¤åºåˆ—å‰è¿› ( std::basic_streambuf<CharT,Traits> 的公开æˆå‘˜å‡½æ•°) | |
| 调用 xsgetn() ( std::basic_streambuf<CharT,Traits> 的公开æˆå‘˜å‡½æ•°) | |
放置区 | |
| 写一个å—符到放置区域，并令 next 指针å‰è¿› ( std::basic_streambuf<CharT,Traits> 的公开æˆå‘˜å‡½æ•°) | |
| 调用 xsputn() ( std::basic_streambuf<CharT,Traits> 的公开æˆå‘˜å‡½æ•°) | |
回放 | |
| 在输入åºåˆ—ä¸æ”¾å›žä¸€ä¸ªå—符 ( std::basic_streambuf<CharT,Traits> 的公开æˆå‘˜å‡½æ•°) | |
| 回移一ä½è¾“出åºåˆ—ä¸çš„下一ä½ç½®æŒ‡é’ˆ ( std::basic_streambuf<CharT,Traits> 的公开æˆå‘˜å‡½æ•°) | |
å—ä¿æŠ¤æˆå‘˜å‡½æ•°
| æž„é€ basic_streambuf 对象 (å—ä¿æŠ¤æˆå‘˜å‡½æ•°) | |
| (C++11) |
æ›¿æ¢ basic_streambuf 对象 (å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| (C++11) |
交æ¢äºŒä¸ª basic_streambuf 对象 (å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
本地环境 | |
| [虚] |
更改关è”的本地环境 ( std::basic_streambuf<CharT,Traits> 的虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
å¯»ä½ | |
| [虚] |
若容许则以用户定义数组替æ¢ç¼“冲区 ( std::basic_streambuf<CharT,Traits> 的虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
用相对寻å€é‡å®šä½è¾“å…¥åºåˆ—ã€è¾“出åºåˆ—或两者ä¸çš„下一ä½ç½®æŒ‡é’ˆ ( std::basic_streambuf<CharT,Traits> 的虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
用ç»å¯¹å¯»å€é‡å®šä½è¾“å…¥åºåˆ—ã€è¾“出åºåˆ—或两者ä¸çš„下一ä½ç½®æŒ‡é’ˆ ( std::basic_streambuf<CharT,Traits> 的虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
将缓冲与关è”çš„å—符åºåˆ—åŒæ¥ ( std::basic_streambuf<CharT,Traits> 的虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
获å–区 | |
| [虚] |
若已知，则获得关è”输入åºåˆ—ä¸å¯ç”¨äºŽè¾“入的å—符数 ( std::basic_streambuf<CharT,Traits> 的虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
从关è”输入åºåˆ—读å–å—符到获å–区 ( std::basic_streambuf<CharT,Traits> 的虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
从输入åºåˆ—读å–å—符到获å–区，并令下一ä½ç½®æŒ‡é’ˆå‰è¿› ( std::basic_streambuf<CharT,Traits> 的虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
从输入åºåˆ—读å–多个å—符 ( std::basic_streambuf<CharT,Traits> 的虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| 返回指å‘获å–区起始ã€å½“å‰å—符和末尾的指针 (å—ä¿æŠ¤æˆå‘˜å‡½æ•°) | |
| 令输出åºåˆ—ä¸çš„下一ä½ç½®æŒ‡é’ˆå‰è¿› (å—ä¿æŠ¤æˆå‘˜å‡½æ•°) | |
| é‡å®šä½è¾“出åºåˆ—的起始ã€ä¸‹ä¸€ä½ç½®å’Œç»ˆæ¢æŒ‡é’ˆ (å—ä¿æŠ¤æˆå‘˜å‡½æ•°) | |
放置区 | |
| [虚] |
将多个å—符写到输出åºåˆ— ( std::basic_streambuf<CharT,Traits> 的虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
从放置区写入å—符到关è”的输出åºåˆ— ( std::basic_streambuf<CharT,Traits> 的虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| 返回指å‘放置区的起始ã€å½“å‰å—符和末尾的指针 (å—ä¿æŠ¤æˆå‘˜å‡½æ•°) | |
| 令输出åºåˆ—ä¸çš„下一ä½ç½®æŒ‡é’ˆå‰è¿› (å—ä¿æŠ¤æˆå‘˜å‡½æ•°) | |
| é‡å®šä½è¾“出åºåˆ—的起始ã€ä¸‹ä¸€ä½ç½®å’Œç»ˆæ¢æŒ‡é’ˆ (å—ä¿æŠ¤æˆå‘˜å‡½æ•°) | |
回放 | |
| [虚] |
å°†å—符放回输入åºåˆ—，å¯èƒ½ä¿®æ”¹è¾“å…¥åºåˆ— ( std::basic_streambuf<CharT,Traits> 的虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |