std::ranges::subrange<I,S,K>::next
ja.cppreference.net より
constexpr subrange next( std::iter_difference_t<I> n = 1 ) const&
requires std::forward_iterator<I>;
|
(1) | (C++20以降) |
constexpr subrange next( std::iter_difference_t<I> n = 1 ) &&;
|
(2) | (C++20以降) |
subrangesubrangebegin_イテレータnnadvance()subrange::advance
1) のコピーを返します。
*this*this と等価です:
auto tmp = *this;tmp.advance(n);return tmp;auto tmp = *this; tmp.advance(n); return tmp;2) からムーブされた を返します。
subrange*this*this*this と等価です:
advance(n);return std::move(*this);auto tmp = std::move(*this); tmp.advance(n); return tmp;パラメータ
| n | - | イテレータの最大増分数 |
戻り値
上記の通り。
注記
この関数と
advance()
の違いは、後者がインプレースでインクリメント（またはデクリメント）を実行することです。
例
このコードを実行
#include <array> #include <iterator> #include <print> #include <ranges> int main() { std::array arr{1, 2, 3, 4, 5, 6, 7}; std::ranges::subrange sub{std::next(arr.begin(), 2), std::prev(arr.end(), 2)}; std::println("1) sub: {}", sub); std::println("2) sub: {}", sub.next()); std::println("3) sub: {}", sub.next(2)); }
出力:
1) sub: [3, 4, 5] 2) sub: [4, 5] 3) sub: [5]
関連項目
指定された距離だけイテレータをデクリメントした
subrange
のコピーを取得する
(公開メンバ関数) |
|
|
指定された距離だけイテレータを進める
(公開メンバ関数) |
|
|
(C++11)
|
イテレータをインクリメントする
(関数テンプレート) |
|
(C++20)
|
指定された距離だけ、または境界までイテレータを進める
(アルゴリズム関数オブジェクト) |