keys_view 클래스(C++ 표준 라이브러리)

컬렉션의 각 튜플과 유사한 값에 대한 첫 번째 인덱스 보기입니다. 예를 들어 범위 std::tuple<string, int>가 지정되면 각 튜플의 모든 요소로 구성된 뷰를 string 만듭니다.

keys_view 는 별칭 elements_view<R, 0> 이며, 연결 컨테이너의 키 보기(예 std::map : 또는 std::unordered_map.)를 만드는 데 유용합니다.

구문

template<input_range R>
using keys_view = ranges::elements_view<R, 0>;

템플릿 매개 변수

R
기본 범위의 형식입니다. 이 형식은 충족 ranges::input_range해야 합니다.

특성 보기

다음 항목에 대한 설명은 클래스 특성 보기를 참조 하세요.

특성	설명
범위 어댑터	views::keys
기본 범위	만족 input_range 하거나 그 이상이어야 합니다.
요소 형식	기본 범위의 첫 번째 튜플 요소 형식과 동일합니다.
반복기 범주 보기	random_access_range 기본 범위가 연속적이면 기본 범위와 동일하지 않습니다.
크기	기본 범위가 충족되는 경우에만 sized_range
반복 const가능	기본 범위가 충족되는 경우에만 const-iterable
공통 범위	기본 범위가 충족되는 경우에만 common_range
빌린 범위	기본 범위가 충족되는 경우에만 borrowed_range

멤버

다음 멤버 함수 목록은 클래스를 keys_view 참조합니다. 클래스 템플릿 인스턴스화의 별칭입니다 element_view .

멤버 함수	설명
생성자C++20	를 생성합니다 keys_view.
baseC++20	기본 범위를 가져옵니다.
beginC++20	첫 번째 요소에 대한 반복기를 가져옵니다.
endC++20	보기의 끝에 있는 sentinel을 가져옵니다.
sizeC++20	요소 수를 가져옵니다. 기본 범위는 충족 sized_range해야 합니다.
에서 상속됨 view_interface	설명
backC++20	마지막 요소를 가져옵니다.
emptyC++20	비어 있는지 테스트 keys_view 합니다.
frontC++20	첫 번째 요소를 가져옵니다.
operator[]C++20	지정된 위치에 있는 요소를 가져옵니다.
operator boolC++20	비어 있지 않은지 테스트 keys_view 합니다.

요구 사항

헤더: <ranges> (C++20 이후)

네임스페이스: std::ranges

컴파일러 옵션: /std:c++20 이상이 필요합니다.

설명

사용할 keys_view 수 있는 튜플과 유사한 형식은 std::tuple, std::pair및 std::array.

생성자

의 인스턴스를 생성합니다 keys_view.

1) constexpr keys_view(V base);
2) keys_view() requires std::default_initializable<V> = default;

매개 변수

base
기본 범위입니다.

템플릿 매개 변수 형식에 대한 자세한 내용은 템플릿 매개 변수를 참조 하세요.

반환 값

keys_view 인스턴스입니다.

설명

범위를 만드는 keys_view 가장 좋은 방법은 범위 어댑터를 사용하는 keys 것입니다. 범위 어댑터는 뷰 클래스를 만드는 데 사용되는 방법입니다. 사용자 고유의 사용자 지정 보기 형식을 만들려는 경우 보기 형식이 노출됩니다.

1) 지정된 뷰에서 만듭니 keys_view 다.
2) 기본 생성자는 빈 keys_view을 만듭니다.

예: keys_view

// requires /std:c++20 or later
#include <ranges>
#include <iostream>
#include <map>
#include <vector>
#include <string>
#include <utility>

int main()
{
    // ========== work with a std::map

    std::map<std::string, int> cpp_standards
    {
        {"C++98", 1988},
        {"C++03", 2003},
        {"C++11", 2011},
        {"C++14", 2014},
        {"C++17", 2017},
        {"C++20", 2020}
    };

    // Extract all of the keys from the map
    for (const std::string& standards : std::views::keys(cpp_standards))
    {
        std::cout << standards << ' '; // C++03 C++11 C++14 C++17 C++98 C++20
    }
    std::cout << '\n';

    // ========== work with a range of std::pair

    std::vector<std::pair<std::string, int>> windows
    {
        {"Windows 1.0", 1985},
        {"Windows 2.0", 1987},
        {"Windows 3.0", 1990},
        {"Windows 3.1", 1992},
        {"Windows NT 3.1", 1993},
        {"Windows 95", 1995},
        {"Windows NT 4.0", 1996},
        {"Windows 95", 1995},
        {"Windows 98", 1998},
        {"Windows 1.0", 1985},
        {"Windows 2000", 2000}
    };
    
    // Another way to call the range adaptor using '|': create an keys_view from each pair
    for (const std::string& version : windows | std::views::keys)
    {
        std::cout << version << ' '; // Windows 1.0 Windows 2.0 Windows 3.0 ...
    }
}

C++03 C++11 C++14 C++17 C++98 c++20
Windows 1.0 Windows 2.0 Windows 3.0 Windows 3.1 Windows NT 3.1 Windows 95 Windows NT 4.0 Windows 95 Windows 98 Windows 1.0 Windows 2000

base

기본 뷰의 복사본을 가져옵니다.

// Uses a copy constructor to return the underlying view
constexpr V base() const& requires std::copy_constructible<V>;

// Uses a move constructor to return the underlying view
constexpr V base() &&;

매개 변수

없음.

반환 값

기본 보기입니다.

begin

에서 첫 번째 요소에 대한 반복기를 가져옵니다 keys_view.

1) constexpr auto begin() requires (!Simple_view<V>);
2) constexpr auto begin() const requires (Simple_view<V>) // or put another way, requires ranges::range<const V>;

매개 변수

없음.

반환 값

의 첫 번째 요소를 keys_view가리키는 반복기입니다.

end

의 끝에 있는 sentinel을 가져옵니다. keys_view

1) constexpr auto end() requires (!Simple_view<V> && !ranges::common_range<V>);
2) constexpr auto end() requires (!Simple_view<V> && ranges::common_range<V>);
3) constexpr auto end() const requires ranges::range<const V>;
4) constexpr auto end() const requires ranges::common_range<const V>;

매개 변수

없음.

반환 값

다음의 마지막 요소 뒤에 있는 sentinel입니다 keys_view.

size

요소 수를 가져옵니다.

constexpr auto size() requires sized_range<V>
constexpr auto size() const requires sized_range<const V>

매개 변수

없음.

반환 값

keys_view의 요소 수입니다.

설명

보기의 크기는 기본 범위 sized_range가 경계인 경우에만 사용할 수 있습니다.

참고 항목

elements_view
values_view
<ranges>
클래스 보기