std::ios_base:: pword

Zunächst wird der private Speicher (dynamisches Array von void * oder einer anderen indizierbaren Datenstruktur) so allokiert oder in der Größe angepasst, dass index ein gültiger Index wird, und dann wird eine Referenz auf das void * -Element des privaten Speichers mit dem Index index zurückgegeben.

Die Referenz kann durch jede Operation an diesem ios_base Objekt ungültig werden, einschließlich eines weiteren Aufrufs von pword() , aber die gespeicherten Werte bleiben erhalten, sodass das spätere Auslesen von pword ( index ) mit demselben Index denselben Wert liefert, bis zum nächsten Aufruf von std::basic_ios::copyfmt() . Der Wert kann für beliebige Zwecke verwendet werden. Der Index des Elements muss durch xalloc() bezogen werden, andernfalls ist das Verhalten undefiniert. Neue Elemente werden mit einem Nullzeiger initialisiert.

Wenn die Funktion fehlschlägt (möglicherweise verursacht durch einen Allokationsfehler) und * this ein Basisklassen-Subobjekt eines basic_ios<> -Objekts oder -Subobjekts ist, ruft sie std:: basic_ios <> :: setstate ( badbit ) auf, was std::ios_base::failure auslösen kann.

Parameter

Rückgabewert

Eine Referenz auf das Element.

Exceptions

Kann std::ios_base::failure auslösen, wenn das badbit gesetzt wird.

Hinweise

Wenn die in pword gespeicherten Zeiger Verwaltung erfordern, register_callback() kann verwendet werden, um Handler zu installieren, die bei Bedarf tiefe Kopie oder Freigabe ausführen.

Beispiel

#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]

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch