다음을 통해 공유


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

조건자와 일치하지 않는 범위의 요소를 필터링하는 뷰입니다.

구문

template<ranges::input_range V, indirect_unary_predicate<iterator_t<V>> Pred>
    requires view<V> && is_object_v<Pred>
class filter_view : public view_interface<filter_view<V, Pred>>;

템플릿 매개 변수

V
기본 범위의 형식입니다.

Pred
유지할 요소를 결정하는 조건자의 형식입니다.

특성 보기

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

특성 설명
범위 어댑터 views::filter
기본 범위 만족 input_range 하거나 그 이상이어야 합니다.
요소 형식 기본 범위와 동일
반복기 범주 보기 input_range, forward_range또는 bidirectional_range 기본 범위에 따라
크기 아니요
반복 const가능 아니요
공통 범위 기본 범위가 충족되는 경우에만 common_range
빌린 범위 기본 범위가 충족되는 경우에만 borrowed_range

멤버

멤버 함수 설명
생성자C++20 뷰를 생성합니다.
baseC++20 기본 범위를 가져옵니다.
beginC++20 첫 번째 요소에 대한 반복기를 가져옵니다.
endC++20 보기의 끝에 있는 sentinel을 가져옵니다.
predC++20 삭제할 요소를 결정하는 조건자 참조를 가져옵니다.
view_interface 상속 설명
backC++20 마지막 요소를 가져옵니다.
emptyC++20 보기가 비어 있는지 테스트합니다.
frontC++20 첫 번째 요소를 가져옵니다.
operator boolC++20 보기가 비어 있지 않은지 테스트합니다.

요구 사항

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

네임스페이스: std::ranges

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

생성자

의 인스턴스 생성 filter_view

1) constexpr filter_view(V base, P pred);
2) filter_view() requires default_initializable<V> && default_initializable<Pred> = default;

매개 변수

base
기본 보기입니다.

pred
기본 보기에서 유지할 요소를 결정하는 조건자입니다.

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

반환 값

filter_view 인스턴스입니다.

설명

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

1) 초기화된 filter_view값을 만듭니다. 조건자와 기본 뷰는 기본 초기화 가능해야 합니다.
2) 이동은 뷰와 pred 조건자에서 base 생성합니다filter_view. 둘 다 basepred 통해 std::move()이동됩니다.

예: filter_view

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

void print(auto v)
{
    for (auto& x : v)
    {
        std::cout << x << ' ';
    }
    std::cout << '\n';
}

int main()
{
    std::vector<int> v{0, 1, -2, 3, -4, -5, 6};
    auto myView = std::views::filter(v, [](int i) {return i > 0; });
    print(myView); // outputs 1 3 6

    auto myView2 = v | std::views::filter([](int i) {return i < 3; });
    print(myView2); // outputs 0 1 -2 -4 -5
}
1 3 6
0 1 -2 -4 -5

base

기본 범위를 가져옵니다.

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

// Uses std::move() to return the underlying range
constexpr V base() &&;

매개 변수

없음

반품

기본 보기입니다.

begin

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

constexpr auto begin();

반환 값

뷰의 첫 번째 요소를 가리키는 반복기입니다. 뷰에 조건자가 없는 경우 동작이 정의되지 않습니다.

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

end

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

constexpr auto end()

반환 값

뷰의 마지막 요소를 따르는 sentinel입니다.

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

pred

삭제할 선행 요소를 결정하는 조건자 참조를 가져옵니다.

constexpr const Pred& pred() const;

반환 값

조건자 참조입니다.

설명

클래스가 조건자를 저장하지 않으면 동작이 정의되지 않습니다.

본보기 pred

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

int main()
{
    std::vector<int> v{0, 1, 2, 3, -4, 5, 6};
    auto mv = v | std::views::filter(
        [](int i) {return i < 5; }); // keep the elements < 5
    
    std::cout << std::boolalpha << mv.pred()(v[6]); // outputs "false" because v[6] = 6 and 6 is not less than 5 (the predicate)
}

참고 항목

<ranges>
filter 범위 어댑터
drop_while()
take_while()
클래스 보기