std::ios_base::xalloc
| static int xalloc(); |
||
Gibt einen eindeutigen (im gesamten Programm gültigen) Indexwert zurück, der verwendet werden kann, um mittels Aufrufen von iword() und pword() auf jeweils ein long und ein void* Element im privaten Speicher von std::ios_base zuzugreifen. Der Aufruf von xalloc reserviert keinen Speicher.
|
Diese Funktion ist threadsicher: Gleichzeitiger Zugriff durch mehrere Threads führt nicht zu einem Datenkonflikt (data race). |
(seit C++11) |
Erhöht effektiv den nächsten verfügbaren eindeutigen Index.
Inhalt |
[edit] Rückgabewert
Eindeutige Ganzzahl zur Verwendung als pword/iword Index.
[edit] Beispiel
Verwendet den pword-Speicher der Basisklasse zur Laufzeit-Typidentifikation von abgeleiteten Stream-Objekten.
#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'; }
Ausgabe
cout, narrow-character test myout, narrow-character test [special handling for mystream] wcout, wide-character test mywout, wide-character test [special handling for mystream]
[edit] Fehlerberichte
Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.
| DR | angewendet auf | Verhalten wie veröffentlicht | Korrigiertes Verhalten |
|---|---|---|---|
| LWG 2143 | C++11 | xalloc war nicht threadsicher |
wurde threadsicher gemacht |
[edit] Siehe auch
| vergrößert den privaten Speicher bei Bedarf und greift auf das void*-Element am gegebenen Index zu (öffentliche Memberfunktion) | |
| vergrößert den privaten Speicher bei Bedarf und greift auf das long-Element am gegebenen Index zu (öffentliche Memberfunktion) |
