Namespaces
Variants

std::ranges::subrange<I,S,K>:: next

From cppreference.net
C++
Ranges library
Range adaptors
std::ranges::subrange
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以降)

subrange を返します。この begin_ は（ n が負の場合はデクリメントされ）インクリメントされます。実際のインクリメント（またはデクリメント）操作は advance() によって実行されます。

1) * this のコピーを返します。
次と同等： auto tmp = * this ;
tmp. advance ( n ) ;
return tmp ; .
2) subrange を * this からムーブしたものを返します。
次と同等： advance ( n ) ;
return std :: move ( * this ) ; .

目次

パラメータ

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)
指定された距離だけ、または境界までイテレータを進める
(アルゴリズム関数オブジェクト)