Namespaces
Variants

std::ranges::adjacent_view<V,N>:: iterator

From cppreference.net
C++
Ranges library
Range adaptors
std::ranges::adjacent_view
Member functions
(C++26)
Iterator
Member functions
Non-member functions
Sentinel
Member functions
Non-member functions
template < bool Const >
class /*iterator*/
(C++23以降)
( 説明専用* )

adjacent_view::begin および、 基盤となるビュー V が common_range である場合の adjacent_view::end の戻り値の型。

型 /*iterator*/ < true > はconst修飾されたオーバーロードによって返されます。型 /*iterator*/ < false > は非const修飾されたオーバーロードによって返されます。

目次

翻訳の説明： - 「Contents」を「目次」に翻訳しました - C++関連の専門用語（Member types、Data members、Member functions、Non-member functions、Example、References、See also）は原文のまま保持しました - HTMLタグ、属性、クラス名、IDなどは一切変更していません - 番号部分もそのまま保持しています - フォーマットと構造は完全に維持されています

メンバー型

メンバー型 定義
Base (private) const V もし Const が true の場合、そうでなければ V 。
( 説明専用メンバー型* )
iterator_category std:: input_iterator_tag
iterator_concept
value_type std:: tuple < /*REPEAT*/ ( ranges:: range_value_t < Base > , N ) ... > ;
difference_type ranges:: range_difference_t < Base >

データメンバ

メンバーオブジェクト 定義
current_ (private) std:: array < ranges:: iterator_t < Base > , N > .
( 説明専用メンバーオブジェクト* )

メンバー関数

イテレータを構築する
(public member function)
要素にアクセスする
(public member function)
インデックスによる要素へのアクセス
(public member function)
基盤となるイテレータを進めるまたは戻す
(public member function)

非メンバー関数

(C++23)
基底のイテレータを比較する
(関数)
(C++23)
イテレータ演算を実行する
(関数)
(C++23)
基底イテレータの間接参照結果を関連する右辺値参照型にキャストする
(関数)
(C++23)
2つの基底イテレータが指すオブジェクトを交換する
(関数)

例

このコードを実行 
#include <cassert>
#include <concepts>
#include <list>
#include <ranges>
#include <tuple>
#include <utility>
#include <vector>
int main()
{
    auto v = std::vector{0, 1, 2, 3, 4, 5};
    auto i = (v | std::views::adjacent<3>).begin();
    using I = decltype(i);
    static_assert(std::same_as<I::value_type, std::tuple<int, int, int>>);
    static_assert(std::same_as<I::iterator_concept, std::random_access_iterator_tag>);
    // 利用可能な演算子の一部:
    ++i; i++; --i; i--; i += 2; i -= 2;
    assert(i[2] == std::tuple(2, 3, 4));
    using DI = decltype(*i);
    static_assert(std::same_as<DI, std::tuple<int&, int&, int&>>);
    std::get<1>(*i) = 42; // イテレータ i を介して v[1] を変更
    assert(v[1] == 42);
    auto l = std::list{0, 1, 2, 3, 4, 5};
    auto j = (l | std::views::adjacent<3>).begin();
    using J = decltype(j);
    static_assert(std::same_as<J::value_type, std::tuple<int, int, int>>);
    static_assert(std::same_as<J::iterator_concept, std::bidirectional_iterator_tag>);
    ++j; --j; j++; j--; // 利用可能な演算子の一部
    // j += 2; j -= 2;       // エラー: これらの演算子は双方向イテレータでは利用不可
    // std::ignore() = j[1]; //        双方向イテレータでは利用不可
}

参考文献

  • C++23標準 (ISO/IEC 14882:2024):
  • 26.7.25.3 クラステンプレート adjacent_view::iterator [range.adjacent.iterator]

関連項目