close

std::ios_base::xalloc

来自cppreference.com
 
C++
 
输入/输出库
 
std::ios_base
 
static int xalloc();

返回（程序范围内）唯一的索引值，它能用于通过调用 iword() 和 pword() 访问 std::ios_base 的私有存储中一个 long 和一个 void* 元素。对 xalloc 的调用不分配内存。

此函数线程安全；从多个线程并发访问不会造成数据竞争。

(C++14 起)

相当于自增下一个可用的索引值。

返回值

用作 pword/iword 索引的独有整数。

示例

[编辑]

将基类 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 << "【mystream 的特殊处理】";
    }
};

// 每个 mystream 特化从 xalloc() 获得独有的下标
template<class charT, class traits>
const int mystream<charT, traits>::xindex = std::ios_base::xalloc();

// 此输入/输出操纵符将能用于辨识身为 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，窄字符测试" << mymanip << '\n';
    
    mystream<char> myout(std::cout);
    myout << "myout，窄字符测试" << mymanip << '\n';
    
    std::wcout << "wcout，宽字符测试" << mymanip << '\n';
    
    mystream<wchar_t> mywout(std::wcout);
    mywout << "mywout，宽字符测试" << mymanip << '\n';
}

输出： 

cout，窄字符测试
myout，窄字符测试【mystream 的特殊处理】
wcout，宽字符测试
mywout，宽字符测试【mystream 的特殊处理】

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告 应用于 出版时的行为 正确行为
LWG 2143 C++11 xalloc 线程不安全 使之线程安全

参阅

 若需要则调整私有存储的大小，并访问位于给定索引的 void* 元素
(公开成员函数) [编辑]
若必要则调整私有存储的大小，并访问位于给定索引的 long 元素
(公开成员函数) [编辑]