std::ranges::prev

来自cppreference.com
< cpp‎ | iterator
 
 
迭代器库
迭代器概念
迭代器原语
算法概念与工具
间接可调用概念
常用算法要求
(C++20)
(C++20)
(C++20)
工具
(C++20)
迭代器适配器
迭代器操作
(C++11)  
(C++11)
ranges::prev
(C++20)
范围访问
(C++11)(C++14)
(C++14)(C++14)  
(C++11)(C++14)
(C++14)(C++14)  
(C++17)(C++20)
(C++17)
(C++17)
 
在标头 <iterator> 定义
调用签名
template< std::bidirectional_iterator I >
constexpr I prev( I i );
(1) (C++20 起)
template< std::bidirectional_iterator I >
constexpr I prev( I i, std::iter_difference_t<I> n );
(2) (C++20 起)
template< std::bidirectional_iterator I >
constexpr I prev( I i, std::iter_difference_t<I> n, I bound );
(3) (C++20 起)

返回迭代器 i 的第 n 个前驱。

此页面上描述的函数式实体是 niebloid,即:

实践中,可以作为函数对象,或者用某些特殊编译器扩展实现它们。

参数

i - 迭代器
n - 要减少 i 的次数
bound - 迭代器,代表 i 所指向的范围的起始

返回值

1) i 的前驱。
2) 迭代器 i 的第 n 个前驱
3) 迭代器 i 的第 n 个前驱,或首个比较等于 bound 的迭代器,取决于何者先达成。

复杂度

1) 常数。
2,3)I 实现 std::random_access_iterator<I> 则为常数;否则为线性。

可能的实现

struct prev_fn
{
    template<std::bidirectional_iterator I>
    constexpr I operator()(I i) const
    {
        --i;
        return i;
    }
 
    template<std::bidirectional_iterator I>
    constexpr I operator()(I i, std::iter_difference_t<I> n) const
    {
        ranges::advance(i, -n);
        return i;
    }
 
    template<std::bidirectional_iterator I>
    constexpr I operator()(I i, std::iter_difference_t<I> n, I bound) const
    {
        ranges::advance(i, -n, bound);
        return i;
    }
};
 
inline constexpr auto prev = prev_fn();

注解

尽管对于容器,表达式 --r.end() 经常能编译,但不保证如此:r.end() 是右值表达式,而没有“指定右值的自减保证可用”的迭代器要求。尤其是迭代器实现为指针或其 operator-- 带有左值引用限定时,--r.end() 不能编译,而 ranges::prev(r.end()) 能。

不实现 ranges::common_range 的范围加剧了这一情况。例如对于某些底层类型,ranges::transform_view::endranges::transform_view::begin 拥有不同的返回类型,故 --r.end() 将不能编译。此非 ranges::prev 所能帮助,但有一些变通方法。

示例

#include <iostream>
#include <iterator>
#include <vector>
 
int main() 
{
    std::vector<int> v{3, 1, 4};
    auto pv = std::ranges::prev(v.end(), 2);
    std::cout << *pv << '\n';
 
    pv = std::ranges::prev(pv, 42, v.begin());
    std::cout << *pv << '\n';
}

输出:

1
3

参阅

自增迭代器给定的距离或到边界
(niebloid)
令迭代器前进给定的距离或到给定的边界
(niebloid)
(C++11)
令迭代器自减
(函数模板)