std::ranges::views::slide, std::ranges::slide_view
| 헤더 <ranges>
|
||
template< ranges::forward_range V >
requires ranges::view<V>
class slide_view
: public ranges::view_interface<slide_view<V>>
|
에 정의됨 (1) | (C++23부터) |
namespace views {
inline constexpr /* unspecified */ slide = /* unspecified */;
}
|
(2) | (C++23부터) |
| 호출 서명 |
||
template< ranges::viewable_range R >
constexpr ranges::view auto slide( R&& r, ranges::range_difference_t<R> n );
|
(C++23부터) | |
template< class DifferenceType >
constexpr /* range adaptor object */ slide( DifferenceType&& n );
|
(C++23부터) | |
| 도우미 개념 |
||
template< class V >
concept /*slide-caches-nothing*/ =
ranges::random_access_range<V> && ranges::sized_range<V>;
|
(3) | (설명 전용*) |
template< class V >
concept /*slide-caches-last*/ =
!/*slide-caches-nothing*/<V> &&
ranges::bidirectional_range<V> && ranges::common_range<V>;
|
(4) | (설명 전용*) |
template< class V >
concept /*slide-caches-first*/ =
!/*slide-caches-nothing*/<V> && !/*slide-caches-last*/<V>;
|
(5) | (설명 전용*) |
slide_view view와 숫자 n를 받아서, 원본 view의 mth개 요소에 대한 view(각각 "윈도우")들을 요소로 하는 view를 생성하는 range 어댑터입니다.[m, m + n - 1] s이라 할 때, 생성된 view의 크기는 다음과 같습니다:
s - n + 1, 만약s >= n이라면,0그렇지 않으면 결과 view는 비어 있습니다.
views::slide은 RangeAdaptorObject를 나타냅니다. 부분식 e과 n이 주어졌을 때, 표현식 views::slide(e, n)은 expression-equivalent합니다. slide_view(e, n)와 동치입니다.만약 n이 0보다 크지 않다면, 동작은 정의되지 않습니다.
slide_view는 항상 forward_range를 모델링하며, 적응된 view 타입이 해당 개념을 모델링한다면 bidirectional_range, random_access_range, 또는 sized_range를 모델링합니다.
데이터 멤버
| 멤버 | 설명 |
V
base_
|
기본 뷰
( 설명 전용 멤버 객체* ) |
ranges::
range_difference_t
<
V
>
n_
|
"윈도우" 크기
( 설명 전용 멤버 객체* ) |
non-propagating-cache
<
ranges::
iterator_t
<
V
>>
cached_begin_
(다음 경우에만 존재:
V
가 다음을 모델링할 때
slide-caches-first
)
|
begin()
의 결과를 캐싱하는 객체
( 설명 전용 멤버 객체* ) |
non-propagating-cache
<
ranges::
iterator_t
<
V
>>
cached_end_
(다음 경우에만 존재:
V
가 다음을 모델링할 때
slide-caches-last
)
|
end()
의 결과를 캐싱하는 객체
( 설명 전용 멤버 객체* ) |
멤버 함수
slide_view
를 생성합니다
(public 멤버 함수) |
|
|
시작 부분에 대한 반복자를 반환합니다
(public 멤버 함수) |
|
|
끝 부분에 대한 반복자나 센티널을 반환합니다
(public 멤버 함수) |
|
기본(적응된) 범위가
sized_range
를 만족할 때만 제공되는 요소의 개수를 반환합니다
(public 멤버 함수) |
|
|
(C++26)
|
결과
approximately_sized_range
의 대략적인 크기를 반환합니다
(public 멤버 함수) |
ranges::view_interface | |
| empty파생 뷰가 비어 있는지 반환하며, sized_range 또는 forward_range std::ranges::view_interface<D>를 만족할 경우에만 제공됨 (
| |
cbegin |
(C++23) 범위의 시작을 가리키는 상수 반복자를 반환함 ( std::ranges::view_interface<D>의 공개 멤버 함수)
|
(C++23) |
범위의 상수 반복자에 대한 종점 구분자를 반환함 ( 의 공개 멤버 함수) std::ranges::view_interface<D>
|
| 파생 뷰가 비어 있지 않은지 반환하며, ranges::empty가 적용 가능한 경우에만 제공됨 ( 의 공개 멤버 함수) std::ranges::view_interface<D>
| |
| 파생 뷰의 첫 번째 요소를 반환하며, forward_range 를 만족할 경우에 제공됨 ( std::ranges::view_interface<D>의 공개 멤버 함수)
| |
| 파생 뷰의 마지막 요소를 반환하며, bidirectional_range와 common_range 를 모두 만족할 경우에만 제공됨 ( std::ranges::view_interface<D>의 공개 멤버 함수)
| |
파생 뷰의 n번째 요소를 반환하며, random_access_range 를 만족할 경우에만 제공됨 ( std::ranges::view_interface<D>의 공개 멤버 함수)
| |
추론 가이드
중첩 클래스
|
(C++23)
|
반복자 타입
( 설명 전용 멤버 클래스 템플릿* ) |
|
(C++23)
|
slide_view
가
common_range
가 아닐 때 사용되는 센티넬 타입
( 설명 전용 멤버 클래스 템플릿* ) |
헬퍼 템플릿
|
template
<
class
V
>
constexpr
bool
ranges::
enable_borrowed_range
<
slide_view
<
V
>>
=
|
(C++23부터) | |
ranges::enable_borrowed_range
의 이 특수화는 기본 뷰가 이를 만족할 때
slide_view
가
borrowed_range
를 만족하도록 합니다.
참고 사항
ranges::adjacent_view 와 ranges::slide_view 사이에는 유사점이 있습니다:
-
둘 다 크기가
N인 "슬라이딩 윈도우"를 생성합니다. -
둘 다 동일한 크기
S - N + 1을 가지며, 여기서S는S >= N > 0을 만족하는 적응된view의 크기입니다.
다음 표는 이러한 어댑터 간의 차이점을 보여줍니다:
| 뷰 어댑터 |
value_type
|
윈도우 크기
N
|
|---|---|---|
| ranges:: adjacent_view | std::tuple | 템플릿 매개변수 |
| ranges :: slide_view | ranges:: range | 런타임 인수 |
| 기능 테스트 매크로 | 값 | 표준 | 기능 |
|---|---|---|---|
__cpp_lib_ranges_slide
|
202202L
|
(C++23) |
std::ranges::slide_view
|
예제
#include <algorithm> #include <initializer_list> #include <iostream> #include <ranges> auto print_subrange = [](std::ranges::viewable_range auto&& r) { std::cout << '['; for (char space[]{0,0}; auto elem : r) std::cout << space << elem, *space = ' '; std::cout << "] "; }; int main() { const auto v = {1, 2, 3, 4, 5, 6}; std::cout << "All sliding windows of width:\n"; for (const unsigned width : std::views::iota(1U, 1U + v.size())) { auto const windows = v | std::views::slide(width); std::cout << "W = " << width << ": "; std::ranges::for_each(windows, print_subrange); std::cout << '\n'; } }
출력:
All sliding windows of width W: W = 1: [1] [2] [3] [4] [5] [6] W = 2: [1 2] [2 3] [3 4] [4 5] [5 6] W = 3: [1 2 3] [2 3 4] [3 4 5] [4 5 6] W = 4: [1 2 3 4] [2 3 4 5] [3 4 5 6] W = 5: [1 2 3 4 5] [2 3 4 5 6] W = 6: [1 2 3 4 5 6]
참조문헌
- C++23 표준 (ISO/IEC 14882:2024):
-
- 26.7.29 슬라이드 뷰 [range.slide]
참고 항목
적응된 뷰의 인접한 요소들에 대한 참조의 튜플로 구성된
view
(클래스 템플릿) (범위 어댑터 객체) |
|
|
(C++23)
|
다른
view
의 요소들을
N
크기의 겹치지 않는 연속적인 청크로 나타낸
view
s
의 범위
(클래스 템플릿) (범위 어댑터 객체) |