Namespaces
Variants

    std::ranges::cbegin

    출처: ko.cppreference.net
     
    C++
    컴파일러 지원
    프리스탠딩 및 호스티드
    언어
    표준 라이브러리
    표준 라이브러리 헤더
    명명된 요구 사항
    기능 테스트 매크로 (C++20)
    언어 지원 라이브러리
    개념 라이브러리 (C++20)
    진단 라이브러리
    메모리 관리 라이브러리
    메타프로그래밍 라이브러리 (C++11)
    일반 유틸리티 라이브러리
    컨테이너 라이브러리
    반복자 라이브러리
    Ranges 라이브러리 (C++20)
    알고리즘 라이브러리
    문자열 라이브러리
    텍스트 처리 라이브러리
    수치 라이브러리
    날짜 및 시간 라이브러리
    입출력 라이브러리
    파일 시스템 라이브러리 (C++17)
    동시성 지원 라이브러리 (C++11)
    실행 제어 라이브러리 (C++26)
    기술 명세
    기호 인덱스
    외부 라이브러리
     
    Ranges 라이브러리
    범위 어댑터
     
    헤더에 정의됨 <ranges>
    헤더에 정의됨 <iterator> 
    inline namespace /* unspecified */ {
    inline constexpr /* unspecified */ cbegin = /* unspecified */;
}
    		(C++20부터)
    (사용자 정의 지점 객체)
    호출 시그니처
    		 
    template< class T >
    requires /* see below */
constexpr /* see below */ auto cbegin( T&& t );
    		(C++20부터)

    const 한정 인자의 첫 번째 요소를 가리키는 반복자를 반환합니다.

    		(C++23까지)

    인자의 첫 번째 요소를 가리키는 상수 반복자를 반환합니다.

    		(C++23부터)

    CT를 다음과 같이 정의합니다:

    • const std::remove_reference_t<T>& 인자가 lvalue인 경우(즉, T이 lvalue 참조 타입인 경우),
    • const T 그렇지 않으면.

    ranges::cbegin 호출은 표현식 동등하여 ranges::begin(static_cast<CT&&>(t))와 같습니다.

    		(C++23까지)

    인자가 lvalue이거나 ranges::enable_borrowed_range<std::remove_cv_t<T>>가 true인 경우, ranges::cbegin 호출은 표현식 동등하여 다음과 같습니다:

    • std::const_iterator<decltype(U)>(U) 일부 표현식 U에 대해 ranges::begin(possibly-const-range(t)와 동등합니다.

    그 외 모든 경우, ranges::cbegin 호출은 잘못된 형식(ill-formed)이며, 이는 호출이 템플릿 인스턴스화의 직접적인 문맥에 나타날 때 치환 실패를 초래할 수 있습니다.

    		(C++23부터)

    반환 타입은 모든 경우에 std::input_or_output_iterator 및 constant-iterator(C++23부터)를 모델링합니다.

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

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

    참고 사항

    lvalue 범위 e (타입 T )에 대해, ranges :: cbegin ( e ) 는 다음과 동일합니다

    ranges:: begin ( std:: as_const ( e ) ) .

    		(C++23 이전)
    (C++23 이후)

    예제

    이 코드 실행 
    #include <cassert>
#include <ranges>
#include <vector>
int main()
{
    std::vector v{3, 1, 4};
    auto vi = std::ranges::cbegin(v);
    assert(3 == *vi);
    ++vi; // OK, 상수 반복자 객체는 변경 가능함
    assert(1 == *vi);
    // *vi = 13; // 오류: 상수 반복자는 불변 요소를 가리킴
    int a[]{3, 1, 4};
    auto ai = std::ranges::cbegin(a); // cbegin은 C-배열에서도 작동함
    assert(3 == *ai and *(ai + 1) == 1);
    // *ai = 13; // 오류: 읽기 전용 변수에 할당할 수 없음
}

    참고 항목

    (C++20)
    		범위의 시작 부분을 가리키는 반복자를 반환합니다
    (커스터마이제이션 포인트 객체)
    (C++11) (C++14)
    		컨테이너나 배열의 시작 부분을 가리키는 반복자를 반환합니다
    (함수 템플릿)