std::ios_base::pword
void*& pword( int index ); |
||
首先,充分地分配或重置私有存储( void* 的动态数组或另一可索引数据结构)以确保 index
是合法下标,然后返回到带下标 index
的私有存储 void* 元素。
引用可能被此 ios_base
对象上任何其他操作非法化,包含另一对 pword()
的调用,但维持返回值,使得以相同下标从 pword(index) 读取将产生相同值(直至下次到 copyfmt() 的调用)。值能用于任何目的。元素下标必须由 xalloc() 获得,否则行为未定义。初始化新元素为空指针。
若分配失败,则调用可能抛出 std::ios_base::failure 的 std::basic_ios<>::setstate(badbit) 。
参数
index | - | 元素的下标值 |
返回值
到该元素的引用。
异常
设置 badbit 时可能抛出 std::ios_base::failure 。
注解
若存储于 pword
的指针要求管理,则可用 register_callback() 安装按需执行深复制或解分配的处理函数。
示例
将基类 pword 存储用于导出的流对象的运行时类型鉴别。
运行此代码
#include <iostream> template<class charT, class traits = std::char_traits<charT> > class mystream : public std::basic_ostream<charT, traits> { public: static const int xindex; mystream(std::basic_ostream<charT, traits>& ostr) : std::basic_ostream<charT, traits>(ostr.rdbuf()) { this->pword(xindex) = this; } void myfn() { *this << "[special handling for mystream]"; } }; // 每个 mystream 特化从 xalloc() 获得独有的下标 template<class charT, class traits> const int mystream<charT, traits>::xindex = std::ios_base::xalloc(); // 此 I/O 操纵符将能用于辨识身为 mystream 的 ostream // 通过查找存储于 pword 的指针 template<class charT, class traits> std::basic_ostream<charT,traits>& mymanip(std::basic_ostream<charT,traits>& os) { if (os.pword(mystream<charT,traits>::xindex) == &os) static_cast<mystream<charT,traits>&>(os).myfn(); return os; } int main() { std::cout << "cout, narrow-character test " << mymanip << '\n'; mystream<char> myout(std::cout); myout << "myout, narrow-character test " << mymanip << '\n'; std::wcout << "wcout, wide-character test " << mymanip << '\n'; mystream<wchar_t> mywout(std::wcout); mywout << "mywout, wide-character test " << mymanip << '\n'; }
输出:
cout, narrow-character test myout, narrow-character test [special handling for mystream] wcout, wide-character test mywout, wide-character test [special handling for mystream]
参阅
如果有必要的话,调整私有存储的大小,并且访问位于提供的下标的long元素 (公开成员函数) | |
[静态] |
返回能安全用作 pword() 和 iword() 下标的程序范围内独有的整数 (公开静态成员函数) |