C++ 参考手册

std::ios_base::pword

void*& pword( int index );

首先，充分地分配或重置私有存储（ void* 的动态数组或另一可索引数据结构）以确保 index 是合法下标，然后返回到带下标 index 的私有存储 void* 元素。

引用可能被此 ios_base 对象上任何其他操作非法化，包含另一对 pword() 的调用，但维持返回值，使得以相同下标从 pword(index) 读取将产生相同值（直至下次到 copyfmt() 的调用）。值能用于任何目的。元素下标必须由 xalloc() 获得，否则行为未定义。初始化新元素为 NULL 。

若分配失败，则调用可能抛出 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() 下标的程序范围内独有的整数
(公开静态成员函数)