Namespaces
Variants

std::ios_base:: xalloc

From cppreference.net
C++
Input/output library
std::ios_base
static int xalloc ( ) ;

プログラム全体で一意なインデックス値を返します。この値は long 型の要素1つと void * 型の要素1つにアクセスするために使用でき、 std::ios_base のプライベートストレージ内で iword() および pword() を呼び出すことでアクセスできます。 xalloc の呼び出しはメモリを割り当てません。

この関数はスレッドセーフです：複数のスレッドによる同時アクセスはデータ競合を引き起こしません。

(since 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++規格に対して遡及的に適用されました。

DR 適用対象 公開時の動作 正しい動作
LWG 2143 C++11 xalloc はスレッドセーフではなかった スレッドセーフに変更

関連項目

必要に応じてプライベートストレージをリサイズし、指定されたインデックスの void * 要素にアクセスします
(公開メンバ関数)
必要に応じてプライベートストレージをリサイズし、指定されたインデックスの long 要素にアクセスします
(公開メンバ関数)