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

constexpr subrange& advance( std::iter_difference_t<I> n );

반복자를 증가시키거나 감소시킵니다begin_ :

• 만약 I이 bidirectional_iterator를 만족하고 n < 0가 true이면, begin_을 -n개의 요소만큼 감소시킵니다.

다음과 동등합니다: ranges::advance(begin_ , n);
if constexpr (StoreSize )
    size_ += to-unsigned-like (-n);
return *this;.

• 그렇지 않으면, begin_을 n개의 요소만큼 증가시키거나, end_에 도달할 때까지 증가시킵니다.

다음과 동등합니다: auto d = n - ranges::advance(begin_ , n, end_ );
if constexpr (StoreSize )
    size_ -= to-unsigned-like (d);
return *this;.

ranges::advance의 전제 조건에 따라, 만약 n < 0가 true이고 begin_을 -n개의 요소만큼 감소시킬 수 없다면, 동작은 정의되지 않습니다.

매개변수

반환값

* this

예제

#include <algorithm>
#include <array>
#include <iostream>
#include <iterator>
#include <ranges>
void print(auto name, auto const sub)
{
    std::cout << name << ".size() == " << sub.size() << "; { ";
    std::ranges::for_each(sub, [](int x) { std::cout << x << ' '; });
    std::cout << "}\n";
};
int main()
{
    std::array arr{1, 2, 3, 4, 5, 6, 7};
    std::ranges::subrange sub{std::next(arr.begin()), std::prev(arr.end())};
    print("1) sub", sub);
    print("2) sub", sub.advance(3));
    print("3) sub", sub.advance(-2));
}

1) sub.size() == 5; { 2 3 4 5 6 }
2) sub.size() == 2; { 5 6 }
3) sub.size() == 4; { 3 4 5 6 }

결함 보고서

다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

참고 항목