std::ios_base::pword
來自 cppreference.com
| void*& pword( int index ); |
||
首先，分配或調整私有儲存（void* 的動態陣列或其他可索引資料結構）的大小，使其足以使 index 成為一個有效索引，然後返回對私有儲存中索引為 index 的 void* 元素的引用。
該引用可能因對此 ios_base 物件的任何操作（包括對 pword() 的另一次呼叫）而失效，但儲存的值會保留，因此稍後使用相同的索引從 pword(index) 讀取將產生相同的值，直到下一次呼叫 std::basic_ios::copyfmt()。該值可用於任何目的。元素的索引必須透過 xalloc() 獲取，否則行為未定義。新元素被初始化為空指標。
如果函式失敗（可能由分配失敗引起）且 *this 是 basic_ios<> 物件或子物件的基類子物件，則呼叫 std::basic_ios<>::setstate(badbit)，這可能會丟擲 std::ios_base::failure。
目錄 |
[編輯] 引數
| index | - | 元素的索引值 |
[編輯] 返回值
元素的引用。
[編輯] 異常
設定 badbit 時可能會丟擲 std::ios_base::failure。
[編輯] 注意
如果儲存在 pword 中的指標需要管理，可以使用 register_callback() 來安裝根據需要執行深複製或解除分配的處理程式。
[編輯] 示例
使用基類 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 36 | C++98 | 如果引用失效，儲存的值可能不會 被保留 |
儲存的值將被保留 直到下次呼叫 copyfmt() |
| LWG 41 | C++98 | 函式在失敗時自行設定 badbit， 但 ios_base 不提供此類介面 |
badbit 由 basic_ios 設定（如果 *this 是其基類子物件） |
[編輯] 參閱
| 如有必要，調整私有儲存的大小，並訪問給定索引處的 long 元素 (公共成員函式) | |
| [靜態] |
返回一個程式範圍內的唯一整數，可安全地用作 pword() 和 iword() 的索引 (公共靜態成員函式) |
