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::strstreambuf
std::strstreambuf
std::strstreambuf 是关è”å—符åºåˆ—为å—符数组的 std::basic_streambuf ，该数组å¯ä¸ºå¸¸é‡ï¼ˆä¾‹å¦‚å—符串å—é¢é‡ï¼‰ã€å¯ä¿®æ”¹ä½†éžåŠ¨æ€æˆ–动æ€ï¼Œè¯¥æƒ…况下å¯ä»¥å…许 std::strstreambuf é‡åˆ†é…数组以适应输出（例如通过调用 delete[] å’Œ new[] 或用户æ供函数）。
std::strstreambuf 的典型实现ä¿æœ‰å››ä¸ªç§æœ‰æ•°æ®æˆå‘˜ï¼š
1) 缓冲区状æ€ï¼Œä¸ºä½æŽ©ç 类型，能表示四个值“已分é…â€ï¼ˆæžæž„函数将解分é…）ã€â€œå¸¸é‡â€ï¼ˆä¸å…许输出）ã€â€œåŠ¨æ€â€ï¼ˆè¾“出将解分é…）或“冻结â€ï¼ˆä¸å…许解分é…å’Œé‡åˆ†é…）的任何组åˆï¼›
2) 分é…的缓冲区大å°ï¼ˆç¼“冲区的起点ä¸å¿…是特别的数æ®æˆå‘˜ï¼Œå®ƒå¯å˜å‚¨äºŽç»§æ‰¿çš„指针 eback() ）；
3) 指å‘用户æ供的分é…函数的指针；
4) 指å‘用户æ供的解分é…函数的指针。
注æ„
在任何以动æ€ç¼“冲区在æµä¸Šè°ƒç”¨ str() åŽï¼Œè¦æ±‚调用 freeze(false) 以å…许 strstreambuf çš„æžæž„函数在需è¦æ—¶è§£åˆ†é…缓冲区。
æˆå‘˜å‡½æ•°
公开æˆå‘˜å‡½æ•° | |
| æž„é€ strstreambuf 对象 (公开æˆå‘˜å‡½æ•°) | |
| [虚] |
é”€æ¯ strstreambuf 对象，å¯é€‰åœ°è§£åˆ†é…å—符数组 (虚公开æˆå‘˜å‡½æ•°) |
| 设置/æ¸…é™¤ç¼“å†²åŒºçš„å†»ç»“çŠ¶æ€ (公开æˆå‘˜å‡½æ•°) | |
| æ ‡è®°ç¼“å†²ä¸ºå†»ç»“å¹¶è¿”å›žè¾“å…¥åºåˆ—的起始指针 (公开æˆå‘˜å‡½æ•°) | |
| 返回输出åºåˆ—ä¸ä¸‹ä¸€ä½ç½®æŒ‡é’ˆå‡èµ·å§‹æŒ‡é’ˆï¼šå†™å…¥å—符数 (公开æˆå‘˜å‡½æ•°) | |
å—ä¿æŠ¤æˆå‘˜å‡½æ•° | |
| [虚] |
从输入åºåˆ—读å–一个å—符而ä¸å‰è¿›ä¸‹ä¸€ä½ç½®æŒ‡é’ˆ (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
回退输入åºåˆ—以å获å–一个å—符 (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
åŽé™„å—符到输出åºåˆ—，å¯èƒ½é‡åˆ†é…或åˆå§‹åœ°åˆ†é…缓冲区，若它为动æ€ä¸”未被冻结 (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
试图以数组替æ¢å—控制å—符åºåˆ— (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
用相对寻å€é‡å¯»ä½è¾“å…¥åºåˆ—ã€è¾“出åºåˆ—或两者ä¸çš„下一ä½ç½®æŒ‡é’ˆ (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
用ç»å¯¹å¯»å€é‡å¯»ä½è¾“å…¥åºåˆ—ã€è¾“出åºåˆ—或两者ä¸çš„下一ä½ç½®æŒ‡é’ˆ (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
继承自 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> 的虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |