std::ios_base::xalloc

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵符

打印函数 (C++23)

C 风格 I/O

缓冲区

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

文件 I/O

basic_ifstream

basic_ofstream

basic_fstream

字符串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

数组 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步的输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

std::ios_base

成员函数

ios_base::ios_base

ios_base::~ios_base

ios_base::operator=

格式化

ios_base::flags

ios_base::setf

ios_base::unsetf

ios_base::precision

ios_base::width

本地环境

ios_base::imbue

ios_base::getloc

内部可扩展数组

ios_base::xalloc

ios_base::iword

ios_base::pword

杂项

ios_base::register_callback

ios_base::sync_with_stdio

成员类

ios_base::failure

ios_base::Init

成员类型

ios_base::openmode

ios_base::fmtflags

ios_base::iostate

ios_base::seekdir

ios_base::event

ios_base::event_callback

 

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 线程不安全	使之线程安全

参阅

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