Spec-Zone.ru › C++

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

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]

См. также

next
получает копию subrange с итератором, перемещённым на заданное расстояние
(открытая функция-член)
advance
перемещает итератор на заданное расстояние
(открытая функция-член)
prev
(C++11)
уменьшает значение итератора
(шаблон функции)
ranges::prev
(C++20)
уменьшает значение итератора на заданное расстояние или до границы
(объект-функция алгоритма)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/ranges/subrange/prev

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API