GeezerVison is showing cpprefjp.github.io — std::ranges::next - cpprefjp C++日本語リファレンス
最終更新日時:
2026年09月19日 21時31分51秒 (JST)
rotarymars
が更新
function template
<iterator>
std::ranges:: next (C++20)
概要
n回あるいは指定された位置まで前方に進めたイテレータを返す。
ranges::advance() n回進んだイテレータのコピーを返す。
引数
x -- 進行の出発位置を示すイテレータn -- 進める距離bound -- 進行の目的地となる位置を示すイテレータ（あるいは番兵）
効果
(1) : 以下と等価
(2) : 以下と等価
(3) : 以下と等価
(4) : 以下と等価
戻り値
(1) : xを1進めたイテレータのコピーを返す
(2) : xをn進めたイテレータのコピーを返す
(3) : xをboundまで進めたイテレータのコピーを返す
(4) : xをbound以内でn進めたイテレータのコピーを返す
備考
この関数テンプレートは通常の名前探索で発見されている場合にADLを無効化する。詳しくは「ADLを無効にする関数定義 」を参照のこと。
例
#include <iostream>
#include <iterator>
#include <vector>
int main () {
std::vector < int > vec = { 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8 , 9 , 10 };
auto it = std::begin ( vec );
// (1)、1つ進める
auto pos2 = std::ranges::next ( it );
std::cout << * pos2 << std::endl ;
// (2)、3進める
auto pos4 = std::ranges::next ( it , 3 );
std::cout << * pos4 << std::endl ;
// (2)、-3進める
auto pos1 = std::ranges::next ( pos4 , -3 );
std::cout << * pos1 << std::endl ;
auto bound = std::ranges::next ( it , 5 ); // 6の位置
// (3)、boundまで進める
auto pos6 = std::ranges::next ( it , bound );
std::cout << * pos6 << std::endl ;
// (4)、boundまでの間で、8進める
auto pos6_2 = std::ranges::next ( it , 8 , bound );
std::cout << * pos6_2 << std::endl ;
// (4) boundまでの間で、4進める
auto pos5 = std::ranges::next ( it , 4 , bound );
std::cout << * pos5 << std::endl ;
}
出力
2
4
1
6
6
5
バージョン
言語
処理系
関連項目
参照