reverse_iterator クラス

[アーティクル]
06/09/2015

このテンプレートクラスは、逆方向でのみランダムアクセス反復子または双方向反復子のように動作する反転反復子オブジェクトを表す反復子アダプターです。これは範囲の後方走査を有効にします。

template <class RandomIterator>
class reverse_iterator

パラメーター

RandomIterator
逆方向に動作するように適合させる反復子を表す型。

解説

既存の標準テンプレートライブラリのコンテナーは、reverse_iterator 型および const_reverse_iterator 型も定義し、反転反復子を返すメンバー関数 rbegin および rend を備えています。これらの反復子には、上書きセマンティクスがあります。 reverse_iterator アダプターは、この機能を補完して挿入セマンティクスを提供し、ストリームで使用できるようにします。

双方向反復子を必要とする reverse_iterator で、ランダムアクセス反復子でのみ使用できるメンバー関数 operator+=、operator+、operator-=、operator-、または operator[] を呼び出すことはできません。

反復子の範囲が [_First, _Last) である場合、左側の角かっこは _First を包むことを指定し、右側のかっこは _Left に至るまでの要素は含むが、_Left 自体は除外することを指定します。同じ要素が反転シーケンス [rev – _First, rev – _Left) に含まれます。_Left がシーケンス内で末尾の 1 つ次の要素である場合、反転シーケンス内の最初の要素 rev – _First は *(_Left – 1 ) を指します。すべての反転反復子を基になる反復子に関連付ける識別子は、次のとおりです。

&*(reverse_iterator ( i ) ) == &*( i – 1 ).

実際には、反転シーケンスで reverse_iterator は、元のシーケンスで反復子が参照する要素の 1 つ次の (右側にある) 要素を参照することを意味します。したがって、反復子がシーケンス (2、4、6、8) で要素 6 を指定する場合、reverse_iterator は反転シーケンス (8、6、4、2) の 4 要素を指定します。

コンストラクター

reverse_iterator

基になる反復子の既定の reverse_iterator または reverse_iterator を構築します。

Typedef

difference_type	同じコンテナー内の要素を参照する 2 つの reverse_iterator の違いを提供する型。
iterator_type	reverse_iterator に基になる反復子を提供する型。
pointer	reverse_iterator によってアドレス指定される要素へのポインターを提供する型。
参照	reverse_iterator によってアドレス指定される要素への参照を提供する型。

メンバー関数

base	その reverse_iterator から基になる反復子を復元します。

演算子

operator*	reverse_iterator がアドレス指定する要素を返します。
operator+	反復子にオフセットを追加し、新しいオフセット位置に挿入された要素をアドレス指定する新しい reverse_iterator アドレスを返します。
operator++	reverse_iterator を次の要素にインクリメントします。
operator+=	指定したオフセットを reverse_iterator から追加します。
operator-	reverse_iterator からオフセットを減算し、オフセット位置にある要素を指定する reverse_iterator を返します。
operator--	reverse_iterator を直前の要素にデクリメントします。
operator-=	指定されたオフセットを reverse_iterator から減算します。
operator->	reverse_iterator によってアドレス指定される要素へのポインターを返します。
operator[]	reverse_iterator によってアドレス指定される要素からの要素のオフセットへの参照を返します。

必要条件

ヘッダー: <iterator>

名前空間: std

次の方法で共有