std::ios_base::iword
提供: cppreference.com
<tbody>
</tbody>
long& iword( int index ); |
||
まず、index を有効なインデックスとするのに十分なようにプライベートな記憶域 (long の動的配列またはインデックス可能な別のデータ構造) を確保またはサイズ変更し、その後そのプライベートな記憶域のインデックス index の long 要素への参照を返します。
この参照はこの ios_base オブジェクトのあらゆる操作 (iword() の別の呼び出しも含みます) によって無効化される可能性がありますが、格納された値は保持されるため、後に同じインデックスを使用して iword(index) から読み込むと同じ値を生成します (std::basic_ios::copyfmt() の次の呼び出しまでは)。 この値は任意の用途に使用できます。 要素のインデックスは xalloc() の以前の呼び出しによって取得したものでなければなりません。 さもなければ動作は未定義です。 新しい要素は 0 に初期化されます。
確保が失敗した場合は、 std::basic_ios<>::setstate(badbit) を呼びます。 これは std::ios_base::failure を投げる場合があります。
ノート
iword の記憶域の一般的な用途はユーザ定義の入出力マニピュレータからユーザ定義の operator<< や operator>> または標準のストリームに設定されたユーザ定義の書式化ファセットに情報 (カスタム書式フラグなど) を渡すことです。
引数
| index | - | 要素のインデックス値 |
戻り値
要素への参照。
例外
badbit がセットされたときに std::ios_base::failure を投げるかもしれません。
例
Run this code
#include <iostream>
#include <string>
struct Foo {
static int foo_xalloc;
std::string data;
Foo(const std::string& s) : data(s) {}
};
// allocates the iword storage for use with Foo objects
int Foo::foo_xalloc = std::ios_base::xalloc();
// This user-defined operator<< prints the string in reverse if the iword holds 1
std::ostream& operator<<(std::ostream& os, Foo& f)
{
if(os.iword(Foo::foo_xalloc) == 1)
return os << std::string(f.data.rbegin(), f.data.rend());
else
return os << f.data;
}
// This I/O manipulator flips the number stored in iword between 0 and 1
std::ios_base& rev(std::ios_base& os)
{
os.iword(Foo::foo_xalloc) = !os.iword(Foo::foo_xalloc);
return os;
}
int main()
{
Foo f("example");
std::cout << f << '\n' << rev << f << '\n' << rev << f << '\n';
}
出力:
example
elpmaxe
example
関連項目
必要であればプライベートな記憶域をリサイズし、指定されたインデックスの void* 要素にアクセスします (パブリックメンバ関数) | |
[静的] |
pword() および iword() へのインデックスとして使用するのに安全な、プログラム全体で一意な整数を返します (パブリック静的メンバ関数) |