std:: iterator
|
ヘッダーで定義
<iterator>
|
||
|
template
<
class
Category,
|
(C++17で非推奨) | |
std::iterator
は、イテレータに必要な型の定義を簡略化するために提供される基底クラスです。
目次 |
テンプレートパラメータ
| カテゴリ | - | イテレータのカテゴリ。 イテレータカテゴリタグ のいずれかでなければならない。 |
| T | - |
イテレータをデリファレンスすることで取得できる値の型。出力イテレータの場合、この型は
void
でなければならない。
|
| Distance | - | イテレータ間の距離を識別するために使用できる型 |
| Pointer | - |
反復対象の型(
T
)へのポインタを定義する
|
| Reference | - |
反復対象の型(
T
)への参照を定義する
|
メンバー型
| メンバー型 | 定義 |
iterator_category
|
Category
|
value_type
|
T
|
difference_type
|
Distance
|
pointer
|
Pointer
|
reference
|
Reference
|
例
以下の例は、std::iteratorを継承して input iterator を実装する方法を示しています。
#include <algorithm> #include <iostream> template<long FROM, long TO> class Range { public: // member typedefs provided through inheriting from std::iterator class iterator : public std::iterator< std::input_iterator_tag, // iterator_category long, // value_type long, // difference_type const long*, // pointer long // reference > { long num = FROM; public: explicit iterator(long _num = 0) : num(_num) {} iterator& operator++() { num = TO >= FROM ? num + 1: num - 1; return *this; } iterator operator++(int) { iterator retval = *this; ++(*this); return retval; } bool operator==(iterator other) const { return num == other.num; } bool operator!=(iterator other) const { return !(*this == other); } reference operator*() const { return num; } }; iterator begin() { return iterator(FROM); } iterator end() { return iterator(TO >= FROM? TO + 1 : TO - 1); } }; int main() { // std::find requires an input iterator auto range = Range<15, 25>(); auto itr = std::find(range.begin(), range.end(), 18); std::cout << *itr << '\n'; // 18 // Range::iterator also satisfies range-based for requirements for (long l : Range<3, 5>()) std::cout << l << ' '; // 3 4 5 std::cout << '\n'; }
出力:
18 3 4 5
関連項目
|
イテレータのプロパティに対する統一インターフェースを提供する
(クラステンプレート) |
|
|
イテレータカテゴリを示すために使用される空のクラス型
(クラス) |