# std::ios_base::pword

< cpp‎ | io‎ | ios base

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]

### 参阅

iword | 如果有必要的话，调整私有存储的大小，并且访问位于提供的下标的long元素 (公开成员函数)
xalloc [静态] | 返回能安全用作 pword() 和 iword() 下标的程序范围内独有的整数 (公开静态成员函数)