std::ranges:: end

범위의 끝을 나타내는 센티널을 반환합니다.

인수가 lvalue이거나 ranges:: enable_borrowed_range < std:: remove_cv_t < T >> 가 true 인 경우, ranges::end 호출은 다음 표현식과 표현식 동등(expression-equivalent) 합니다:

1. t + std:: extent_v < T > 만약 t 가 알려진 경계를 가진 배열 타입인 경우.
   • 만약 std:: remove_all_extents_t < std:: remove_reference_t < T >> 가 불완전한 타입이면, ranges::end 호출은 형식 오류이며, 진단 불필요 입니다.
2. 그렇지 않으면, decay-copy ( t. end ( ) ) (C++23 이전) auto ( t. end ( ) ) (C++23 이후) , 해당 표현식이 유효하고 그 타입이 std:: sentinel_for < ranges:: iterator_t < T >> 를 모델로 하는 경우.
3. 그렇지 않으면, decay-copy ( end ( t ) ) (C++23 이전) auto ( end ( t ) ) (C++23 이후) , 만약 T 가 클래스나 열거형 타입이고, 해당 표현식이 유효하며 변환된 타입이 std:: sentinel_for < ranges:: iterator_t < T >> 를 모델로 하는 경우, 여기서 end 의 의미는 인자 의존적 탐색 만을 수행하는 것으로 설정됩니다.

다른 모든 경우에서 ranges::end 호출은 형식에 맞지 않으며, 이는 치환 실패 를 초래할 수 있습니다. 특히 ranges::end 호출이 템플릿 인스턴스화의 직접적인 문맥에서 나타날 때 그러합니다.

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

이름 ranges::end 는 사용자 지정 지점 객체 를 나타내며, 이는 함수 객체 의 const 리터럴 semiregular 클래스 타입입니다. 자세한 내용은 CustomizationPointObject 를 참조하십시오.

참고 사항

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

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

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

예제

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

found a 5 in array arr!

결함 보고서

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

참고 항목