std::ranges::rend

inline namespace /* unspecified */ {
    inline constexpr /* unspecified */ rend = /* unspecified */;
}

template< class T >
    requires /* see below */
constexpr std::sentinel_for<
    decltype(ranges::rbegin(std::declval<T>()))> auto rend( T&& t );

역방향 범위의 끝을 나타내는 센티넬을 반환합니다.

만약 T이 배열 타입이고 std::remove_all_extents_t<std::remove_reference_t<T>>가 불완전하다면, ranges::rend 호출은 진단 없이 ill-formed입니다.

인수가 lvalue이거나 ranges::enable_borrowed_range<std::remove_cv_t<T>>가 true인 경우, ranges::rend 호출은 다음에 대해 표현식-동등합니다:

1. decay-copy(t.rend())(C++23까지)auto(t.rend())(C++23부터), 만약 해당 표현식이 유효하고 그 타입이 std::sentinel_for<decltype(ranges::rbegin(std::declval<T>()))>를 만족한다면.
2. 그렇지 않으면, 만약 가 클래스 또는 열거형 타입이고, 해당 표현식이 유효하며 그 타입이 (rend(t))를 만족한다면, 여기서 auto(rend(t))의 의미는 오직 인자-의존적 조회T에 의해 확립됩니다.std::sentinel_for<decltype(ranges::rbegin(std::declval<T>()))>그렇지 않으면, 만약 rend과 가 모두 유효한 표현식이고, 같은 타입을 가지며, 그 타입이 std::bidirectional_iterator
3. 를 만족한다면, std::make_reverse_iterator(ranges::begin(t))를 수행합니다.ranges::begin(t)그 외의 모든 경우에, ranges::end(t)에 대한 호출은 ill-formed이며, 이는 가 템플릿 인스턴스화의 즉시 문맥에 나타날 때 치환 실패

를 초래할 수 있습니다. ranges::rend ranges::rend(t)

커스터마이제이션 포인트 객체

ranges::rend 이름은 커스터마이제이션 포인트 객체 를 나타내며, 이는 리터럴 함수 객체 의 const 리터럴 semiregular 클래스 타입입니다. 자세한 내용은 CustomizationPointObject 를 참조하십시오.

참고 사항

인자가 rvalue인 경우(즉, T 가 객체 타입인 경우)이고 ranges:: enable_borrowed_range < std:: remove_cv_t < T >> 가 false 이거나, 알려지지 않은 경계를 가진 배열 타입인 경우, ranges::rend 에 대한 호출은 형식이 잘못되어 치환 실패를 유발합니다.

만약 ranges :: rend ( std:: forward < T > ( t ) ) 가 유효하다면, decltype ( ranges :: rend ( std:: forward < T > ( t ) ) ) 와 decltype ( ranges:: begin ( std:: forward < T > ( t ) ) ) 가 모든 경우에서 std::sentinel_for 를 모델링하는 반면, T 는 std::ranges::range 를 모델링합니다.

C++20 표준은 기본 rend 함수 호출이 prvalue를 반환하는 경우, 반환 값이 구체화된 임시 객체에서 이동 생성되도록 요구합니다. 모든 구현체는 직접 prvalue를 반환합니다. 이 요구사항은 구현체와 일치하도록 C++20 이후 제안서 P0849R8 에 의해 수정되었습니다.

예제

#include <algorithm>
#include <iostream>
#include <ranges>
#include <vector>
int main()
{
    std::vector<int> v = {3, 1, 4};
    namespace ranges = std::ranges;
    if (ranges::find(ranges::rbegin(v), ranges::rend(v), 5) != ranges::rend(v))
        std::cout << "found a 5 in vector v!\n";
    int a[] = {5, 10, 15};
    if (ranges::find(ranges::rbegin(a), ranges::rend(a), 5) != ranges::rend(a))
        std::cout << "found a 5 in array a!\n";
}

found a 5 in array a!

결함 보고서

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

참고 항목