다음을 통해 공유


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

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

values_view 는 별칭 elements_view<R, 1> 이며 , 와 같은 std::unordered_map결합 컨테이너에서 값의 뷰를 만드는 데 유용합니다.

구문

template<input_range R>
using values_view = ranges::elements_view<R, 1>;

템플릿 매개 변수

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

특성 보기

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

특성 설명
범위 어댑터 views::values
기본 범위 만족 forward_range 하거나 그 이상이어야 합니다.
요소 형식 두 번째 튜플 요소의 형식과 동일합니다.
반복기 범주 보기 forward_range, bidirectional_range 또는 random_access_range
크기 기본 범위가 충족되는 경우에만 sized_range
반복 const가능 기본 범위가 충족되는 경우에만 const-iterable
공통 범위 기본 범위가 충족되는 경우에만 common_range
빌린 범위 기본 범위가 충족되는 경우에만 borrowed_range

멤버

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

요구 사항

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

네임스페이스: std::ranges

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

설명

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

생성자

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

1) constexpr values_view(R base);
2) values_view() requires default_initializable<V> = default;

매개 변수

base
튜플과 유사한 형식의 기본 범위입니다.

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

반환 값

values_view 인스턴스입니다.

설명

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

  1. values_view 지정된 뷰에서 만듭니다.
  2. 기본 생성자는 기본 생성 values_view자를 만듭니다.

예: values_view

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

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 values from the map
    for (int years : std::views::values(cpp_standards))
    {
        std::cout << years << ' '; // 2003 2011 2014 2017 1988 2020
    }
    std::cout << '\n';

    // ========== work with a 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 a keys_view from each pair
    for (int years : windows | std::views::values)
    {
        std::cout << years << ' '; // 1985 1987 1990 1992 ...
    }
}
2003 2011 2014 2017 1988 2020
1985 1987 1990 1992 1993 1995 1996 1995 1998 1985 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

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

// returns a non-const iterator
1) constexpr auto begin() requires (!Simple_view<V>);

// returns a const iterator
2) constexpr auto begin() const requires ranges::range<const V>;

매개 변수

없음.

반환 값

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

요소가 10, 20 및 30인 벡터 그림입니다. 첫 번째 요소는 10을 포함하며 begin()이라는 레이블이 지정됩니다. 마지막 요소는 30을 포함하며 '마지막 요소'라는 레이블이 지정됩니다. 마지막 요소 뒤의 허수 상자는 sentinel을 나타내며 end()라는 레이블이 지정됩니다.

end

의 끝에 있는 sentinel을 가져옵니다. values_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입니다. values_view

요소가 10, 20 및 30인 벡터 그림입니다. 첫 번째 요소는 10을 포함하며 begin()이라는 레이블이 지정됩니다. 마지막 요소는 30을 포함하며 '마지막 요소'라는 레이블이 지정됩니다. 마지막 요소 뒤의 허수 상자는 sentinel을 나타내며 end()라는 레이블이 지정됩니다.

size

요소 수를 가져옵니다.

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

매개 변수

없음.

반환 값

values_view의 요소 수입니다.

설명

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

참고 항목

elements_view
keys_view
<ranges>
클래스 보기