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_filebuf
std::basic_filebuf
  class CharT,
  class Traits = std::char_traits<CharT>
std::basic_filebuf 是关è”å—符åºåˆ—为文件的 std::basic_streambuf 。输入åºåˆ—和输出åºåˆ—都关è”到åŒä¸€æ–‡ä»¶ï¼Œå¹¶ä¸ºä¸¤ç§æ“作维护连接文件ä½ç½®ã€‚
函数 underflow() å’Œ overflow()/sync() 进行文件和缓冲区的获å–放置区之间的实际 I/O 。 CharT ä¸æ˜¯ char 时，多数实现在文件å˜å‚¨å¤šå—节å—符，并用 std::codecvt å¹³é¢è¿›è¡Œå®½/多å—节å—符转æ¢ã€‚
亦为常用å—符类型定义二个特化：
| 定义于头文件
<streambuf> | |
| Â | |
| 类型 | 定义 |
filebuf
|
basic_filebuf<char> |
wfilebuf
|
basic_filebuf<wchar_t> |
æˆå‘˜ç±»åž‹
| Â | |
| 定义类型 | 定义 |
char_type
|
CharT |
traits_type
|
Traits ；若 Traits::char_type ä¸æ˜¯ CharT 则程åºä¸ºè°¬æž„。 |
int_type
|
Traits::int_type |
pos_type
|
è¦æ±‚为 std::fpos<Traits::state_type> çš„ Traits::pos_type |
off_type
|
Traits::off_type |
æˆå‘˜å‡½æ•°
公开æˆå‘˜å‡½æ•° | |
| æž„é€ basic_filebuf 对象 (公开æˆå‘˜å‡½æ•°) | |
| (C++11) |
赋值 basic_filebuf 对象 (公开æˆå‘˜å‡½æ•°) |
| (C++11) |
交æ¢äºŒä¸ª basic_filebuf 对象 (公开æˆå‘˜å‡½æ•°) |
| [虚] |
æžæž„ basic_filebuf 对象并且若打开则关é—文件 (虚公开æˆå‘˜å‡½æ•°) |
| 检查关è”文件是å¦æ‰“å¼€ (公开æˆå‘˜å‡½æ•°) | |
| 打开文件并é…置它为关è”å—符åºåˆ— (公开æˆå‘˜å‡½æ•°) | |
| 冲入放置区缓冲区并关é—å…³è”的文件 (公开æˆå‘˜å‡½æ•°) | |
å—ä¿æŠ¤æˆå‘˜å‡½æ•° | |
| [虚] |
å¯é€‰åœ°æä¾›å¯ç”¨äºŽä»Žæ–‡ä»¶è¾“入的å—符数 (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
从关è”æ–‡ä»¶è¯»å– (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
从关è”文件读å–，并令获å–区的下一ä½ç½®æŒ‡é’ˆå‰è¿› (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
回退输出åºåˆ—以放回å—符，ä¸å½±å“å…³è”文件 (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
从放置区写å—符到关è”的文件 (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
æä¾›ç”¨æˆ·ä¾›åº”çš„ç¼“å†²åŒºï¼Œæˆ–å°†æ¤ filebuf 转å˜ä¸ºæ— 缓冲 (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
用相对寻å€é‡å¯»ä½æ–‡ä»¶ä½ç½® (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
用ç»å¯¹å¯»å€é‡å¯»ä½æ–‡ä»¶ä½ç½® (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
从放置区写å—符到关è”文件 (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
| [虚] |
更改关è”的本地环境 (虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |
éžæˆå‘˜å‡½æ•°
| 特化 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> 的虚å—ä¿æŠ¤æˆå‘˜å‡½æ•°) |