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