std::ios_base::xalloc

static int xalloc();

Возвращает уникальное (в пределах всей программы) значение индекса, которое можно использовать для доступа к одному элементу типа long и одному элементу типа void* в закрытом хранилище std::ios_base с помощью вызовов iword() и pword(). Вызов xalloc не выделяет память.

Эта функция потокобезопасна: параллельный доступ из нескольких потоков не приводит к гонке данных.

(начиная с C++11)

Фактически увеличивает следующий доступный уникальный индекс.

Возвращаемое значение

Уникальное целое число, используемое в качестве индекса 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 << "[special handling for mystream]";
    }
};

// Each specialization of mystream obtains a unique index from xalloc()
template<class CharT, class Traits>
const int mystream<CharT, Traits>::xindex = std::ios_base::xalloc();

// This I/O manipulator will be able to recognize ostreams that are mystreams
// by looking up the pointer stored in 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]

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были ретроактивно применены к ранее опубликованным стандартам C++.

Отчёт об ошибке	Применяется к	Опубликованное поведение	Правильное поведение
LWG 2143	C++11	`xalloc` не была потокобезопасной	сделана потокобезопасной

См. также

pword	при необходимости изменяет размер закрытого хранилища и обеспечивает доступ к элементу void* по заданному индексу (открытая функция-член)
iword	при необходимости изменяет размер закрытого хранилища и обеспечивает доступ к элементу long по заданному индексу (открытая функция-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/io/ios_base/xalloc