30 #ifndef _GLIBCXX_RANGES
31 #define _GLIBCXX_RANGES 1
33 #if __cplusplus > 201703L
35 #pragma GCC system_header
39 #if __cpp_lib_concepts
53 namespace std _GLIBCXX_VISIBILITY(default)
55 _GLIBCXX_BEGIN_NAMESPACE_VERSION
69 template<
typename _Tp>
70 concept __deep_const_range = range<_Tp> && range<const _Tp>
71 && same_as<range_reference_t<_Tp>, range_reference_t<const _Tp>>;
73 template<
typename _Tp>
74 inline constexpr
bool __enable_view_impl
75 = derived_from<_Tp, view_base> || (!__deep_const_range<_Tp>);
77 template<
typename _Tp>
78 inline constexpr
bool __enable_view_impl<std::initializer_list<_Tp>>
83 template<
typename _Tp>
84 inline constexpr
bool enable_view
85 = __detail::__enable_view_impl<remove_cv_t<_Tp>>;
87 template<
typename _Tp>
89 = range<_Tp> && movable<_Tp> && default_initializable<_Tp>
93 template<
typename _Tp>
94 concept viewable_range = range<_Tp>
95 && (safe_range<_Tp> || view<decay_t<_Tp>>);
99 template<
typename _Range>
100 concept __simple_view = view<_Range> && range<const _Range>
101 && same_as<iterator_t<_Range>, iterator_t<const _Range>>
102 && same_as<sentinel_t<_Range>, sentinel_t<const _Range>>;
104 template<
typename _It>
105 concept __has_arrow = input_iterator<_It>
106 && (is_pointer_v<_It> || requires(_It __it) { __it.operator->(); });
108 template<
typename _Tp,
typename _Up>
109 concept __not_same_as
110 = !same_as<remove_cvref_t<_Tp>, remove_cvref_t<_Up>>;
113 template<
typename _Derived>
114 requires is_class_v<_Derived> && same_as<_Derived, remove_cv_t<_Derived>>
115 class view_interface :
public view_base
118 constexpr _Derived& _M_derived() noexcept
120 static_assert(derived_from<_Derived, view_interface<_Derived>>);
121 static_assert(view<_Derived>);
122 return static_cast<_Derived&>(*
this);
125 constexpr
const _Derived& _M_derived() const noexcept
127 static_assert(derived_from<_Derived, view_interface<_Derived>>);
128 static_assert(view<_Derived>);
129 return static_cast<const _Derived&>(*
this);
134 empty() requires forward_range<_Derived>
138 empty() const requires forward_range<const _Derived>
142 operator bool() requires requires { ranges::empty(_M_derived()); }
143 {
return !ranges::empty(_M_derived()); }
146 operator bool() const requires requires { ranges::empty(_M_derived()); }
147 {
return !ranges::empty(_M_derived()); }
150 data() requires contiguous_iterator<iterator_t<_Derived>>
155 requires range<const _Derived>
156 && contiguous_iterator<iterator_t<const _Derived>>
161 requires forward_range<_Derived>
162 && sized_sentinel_for<sentinel_t<_Derived>, iterator_t<_Derived>>
167 requires forward_range<const _Derived>
168 && sized_sentinel_for<sentinel_t<const _Derived>,
169 iterator_t<const _Derived>>
172 constexpr decltype(
auto)
173 front() requires forward_range<_Derived>
175 __glibcxx_assert(!empty());
179 constexpr decltype(
auto)
180 front() const requires forward_range<const _Derived>
182 __glibcxx_assert(!empty());
186 constexpr decltype(
auto)
188 requires bidirectional_range<_Derived> && common_range<_Derived>
190 __glibcxx_assert(!empty());
194 constexpr decltype(
auto)
196 requires bidirectional_range<const _Derived>
197 && common_range<const _Derived>
199 __glibcxx_assert(!empty());
203 template<random_access_range _Range = _Derived>
204 constexpr decltype(
auto)
205 operator[](range_difference_t<_Range> __n)
208 template<random_access_range _Range = const _Derived>
209 constexpr decltype(
auto)
210 operator[](range_difference_t<_Range> __n)
const
216 template<
typename _Tp>
218 = !is_reference_v<_Tp> && requires(_Tp __t)
220 typename tuple_size<_Tp>::type;
221 requires derived_from<tuple_size<_Tp>, integral_constant<size_t, 2>>;
222 typename tuple_element_t<0, remove_const_t<_Tp>>;
223 typename tuple_element_t<1, remove_const_t<_Tp>>;
224 { get<0>(__t) } -> convertible_to<const tuple_element_t<0, _Tp>&>;
225 { get<1>(__t) } -> convertible_to<const tuple_element_t<1, _Tp>&>;
228 template<
typename _Tp,
typename _Up,
typename _Vp>
229 concept __pair_like_convertible_to
230 = !range<_Tp> && __pair_like<remove_reference_t<_Tp>>
231 && requires(_Tp&& __t)
233 { get<0>(std::forward<_Tp>(__t)) } -> convertible_to<_Up>;
234 { get<1>(std::forward<_Tp>(__t)) } -> convertible_to<_Vp>;
237 template<
typename _Tp,
typename _Up,
typename _Vp>
238 concept __pair_like_convertible_from
239 = !range<_Tp> && __pair_like<_Tp>
240 && constructible_from<_Tp, _Up, _Vp>;
242 template<
typename _Tp>
243 concept __iterator_sentinel_pair
244 = !range<_Tp> && __pair_like<_Tp>
245 && sentinel_for<tuple_element_t<1, _Tp>, tuple_element_t<0, _Tp>>;
249 enum class subrange_kind : bool { unsized, sized };
251 template<input_or_output_iterator _It, sentinel_for<_It> _Sent = _It,
252 subrange_kind _Kind = sized_sentinel_for<_Sent, _It>
253 ? subrange_kind::sized : subrange_kind::unsized>
254 requires (_Kind == subrange_kind::sized || !sized_sentinel_for<_Sent, _It>)
255 class subrange :
public view_interface<subrange<_It, _Sent, _Kind>>
258 static constexpr
bool _S_store_size
259 = _Kind == subrange_kind::sized && !sized_sentinel_for<_Sent, _It>;
261 _It _M_begin = _It();
262 _Sent _M_end = _Sent();
264 template<
typename,
bool = _S_store_size>
268 template<
typename _Tp>
269 struct _Size<_Tp, true>
270 { __detail::__make_unsigned_like_t<_Tp> _M_size; };
272 [[no_unique_address]] _Size<iter_difference_t<_It>> _M_size = {};
275 subrange() =
default;
278 subrange(_It __i, _Sent __s) requires (!_S_store_size)
279 : _M_begin(
std::
move(__i)), _M_end(__s)
283 subrange(_It __i, _Sent __s,
284 __detail::__make_unsigned_like_t<iter_difference_t<_It>> __n)
285 requires (_Kind == subrange_kind::sized)
286 : _M_begin(
std::
move(__i)), _M_end(__s)
288 using __detail::__to_unsigned_like;
290 if constexpr (_S_store_size)
291 _M_size._M_size = __n;
294 template<__detail::__not_same_as<subrange> _Rng>
295 requires safe_range<_Rng>
296 && convertible_to<iterator_t<_Rng>, _It>
297 && convertible_to<sentinel_t<_Rng>, _Sent>
299 subrange(_Rng&& __r) requires (!_S_store_size || sized_range<_Rng>)
302 if constexpr (_S_store_size)
303 _M_size._M_size = ranges::size(__r);
306 template<safe_range _Rng>
307 requires convertible_to<iterator_t<_Rng>, _It>
308 && convertible_to<sentinel_t<_Rng>, _Sent>
311 __detail::__make_unsigned_like_t<iter_difference_t<_It>> __n)
312 requires (_Kind == subrange_kind::sized)
316 template<__detail::__not_same_as<subrange> _PairLike>
317 requires __detail::__pair_like_convertible_to<_PairLike, _It, _Sent>
319 subrange(_PairLike&& __r) requires (!_S_store_size)
320 : subrange{std::get<0>(std::forward<_PairLike>(__r)),
321 std::get<1>(std::forward<_PairLike>(__r))}
324 template<__detail::__pair_like_convertible_to<_It, _Sent> _PairLike>
326 subrange(_PairLike&& __r,
327 __detail::__make_unsigned_like_t<iter_difference_t<_It>> __n)
328 requires (_Kind == subrange_kind::sized)
329 : subrange{std::get<0>(std::forward<_PairLike>(__r)),
330 std::get<1>(std::forward<_PairLike>(__r)), __n}
333 template<__detail::__not_same_as<subrange> _PairLike>
334 requires __detail::__pair_like_convertible_from<_PairLike,
const _It&,
337 operator _PairLike()
const
338 {
return _PairLike(_M_begin, _M_end); }
341 begin() const requires copyable<_It>
344 [[nodiscard]] constexpr _It
345 begin() requires (!copyable<_It>)
348 constexpr _Sent
end()
const {
return _M_end; }
350 constexpr
bool empty()
const {
return _M_begin == _M_end; }
352 constexpr __detail::__make_unsigned_like_t<iter_difference_t<_It>>
353 size() const requires (_Kind == subrange_kind::sized)
355 if constexpr (_S_store_size)
356 return _M_size._M_size;
358 return __detail::__to_unsigned_like(_M_end - _M_begin);
361 [[nodiscard]] constexpr subrange
362 next(iter_difference_t<_It> __n = 1) const &
363 requires forward_iterator<_It>
370 [[nodiscard]] constexpr subrange
371 next(iter_difference_t<_It> __n = 1) &&
377 [[nodiscard]] constexpr subrange
378 prev(iter_difference_t<_It> __n = 1) const
379 requires bidirectional_iterator<_It>
382 __tmp.advance(--__n);
387 advance(iter_difference_t<_It> __n)
389 if constexpr (_S_store_size)
393 _M_size._M_size -= __detail::__to_unsigned_like(__d);
395 _M_size._M_size += __detail::__to_unsigned_like(-__d);
403 template<input_or_output_iterator _It, sentinel_for<_It> _Sent>
405 __detail::__make_unsigned_like_t<iter_difference_t<_It>>)
406 -> subrange<_It, _Sent, subrange_kind::sized>;
408 template<__detail::__iterator_sentinel_pair _Pr>
410 -> subrange<tuple_element_t<0, _Pr>, tuple_element_t<1, _Pr>>;
412 template<__detail::__iterator_sentinel_pair _Pr>
413 subrange(_Pr, __detail::__make_unsigned_like_t<iter_difference_t<
414 tuple_element_t<0, _Pr>>>)
415 -> subrange<tuple_element_t<0, _Pr>, tuple_element_t<1, _Pr>,
416 subrange_kind::sized>;
418 template<safe_range _Rng>
420 -> subrange<iterator_t<_Rng>, sentinel_t<_Rng>,
422 || sized_sentinel_for<sentinel_t<_Rng>, iterator_t<_Rng>>)
423 ? subrange_kind::sized : subrange_kind::unsized>;
425 template<safe_range _Rng>
427 __detail::__make_unsigned_like_t<range_difference_t<_Rng>>)
428 -> subrange<iterator_t<_Rng>, sentinel_t<_Rng>, subrange_kind::sized>;
430 template<
size_t _Num,
class _It,
class _Sent, subrange_kind _Kind>
433 get(const subrange<_It, _Sent, _Kind>& __r)
435 if constexpr (_Num == 0)
441 template<
size_t _Num, class _It, class _Sent, subrange_kind _Kind>
444 get(subrange<_It, _Sent, _Kind>&& __r)
446 if constexpr (_Num == 0)
452 template<input_or_output_iterator _It, sentinel_for<_It> _Sent,
454 inline constexpr
bool
455 enable_safe_range<subrange<_It, _Sent, _Kind>> = true;
466 constexpr dangling() noexcept = default;
467 template<typename... _Args>
468 constexpr dangling(_Args&&...) noexcept { }
471 template<range _Range>
472 using safe_iterator_t = conditional_t<safe_range<_Range>,
476 template<range _Range>
477 using safe_subrange_t = conditional_t<safe_range<_Range>,
478 subrange<iterator_t<_Range>>,
481 template<
typename _Tp> requires is_object_v<_Tp>
483 :
public view_interface<empty_view<_Tp>>
486 static constexpr _Tp*
begin() noexcept {
return nullptr; }
487 static constexpr _Tp*
end() noexcept {
return nullptr; }
488 static constexpr _Tp* data() noexcept {
return nullptr; }
489 static constexpr
size_t size() noexcept {
return 0; }
490 static constexpr
bool empty() noexcept {
return true; }
493 template<
typename _Tp>
494 inline constexpr
bool enable_safe_range<empty_view<_Tp>> =
true;
498 template<copy_constructible _Tp> requires is_object_v<_Tp>
499 struct __box : std::optional<_Tp>
501 using std::optional<_Tp>::optional;
505 noexcept(is_nothrow_default_constructible_v<_Tp>)
506 requires default_initializable<_Tp>
510 using std::optional<_Tp>::operator=;
513 operator=(
const __box& __that)
514 noexcept(is_nothrow_copy_constructible_v<_Tp>)
515 requires (!assignable_from<_Tp&, const _Tp&>)
518 this->emplace(*__that);
525 operator=(__box&& __that)
526 noexcept(is_nothrow_move_constructible_v<_Tp>)
527 requires (!assignable_from<_Tp&, _Tp>)
540 template<copy_constructible _Tp> requires is_object_v<_Tp>
541 class single_view :
public view_interface<single_view<_Tp>>
544 single_view() =
default;
547 single_view(
const _Tp& __t)
552 single_view(_Tp&& __t)
556 template<
typename... _Args>
557 requires constructible_from<_Tp, _Args...>
559 single_view(in_place_t, _Args&&... __args)
560 : _M_value{
in_place, std::forward<_Args>(__args)...}
568 begin() const noexcept
573 {
return data() + 1; }
577 {
return data() + 1; }
579 static constexpr
size_t
585 {
return _M_value.operator->(); }
588 data() const noexcept
589 {
return _M_value.operator->(); }
592 __detail::__box<_Tp> _M_value;
597 template<
typename _Wp>
598 constexpr
auto __to_signed_like(_Wp __w) noexcept
600 if constexpr (!integral<_Wp>)
601 return iter_difference_t<_Wp>();
602 else if constexpr (
sizeof(iter_difference_t<_Wp>) >
sizeof(_Wp))
603 return iter_difference_t<_Wp>(__w);
604 else if constexpr (
sizeof(ptrdiff_t) >
sizeof(_Wp))
605 return ptrdiff_t(__w);
606 else if constexpr (
sizeof(
long long) >
sizeof(_Wp))
607 return (
long long)(__w);
608 #ifdef __SIZEOF_INT128__
609 else if constexpr (__SIZEOF_INT128__ >
sizeof(_Wp))
610 return __int128(__w);
613 return __max_diff_type(__w);
616 template<
typename _Wp>
617 using __iota_diff_t = decltype(__to_signed_like(std::declval<_Wp>()));
619 template<
typename _It>
620 concept __decrementable = incrementable<_It>
623 { --__i } -> same_as<_It&>;
624 { __i-- } -> same_as<_It>;
627 template<
typename _It>
628 concept __advanceable = __decrementable<_It> && totally_ordered<_It>
629 && requires( _It __i,
const _It __j,
const __iota_diff_t<_It> __n)
631 { __i += __n } -> same_as<_It&>;
632 { __i -= __n } -> same_as<_It&>;
636 { __j - __j } -> convertible_to<__iota_diff_t<_It>>;
641 template<weakly_incrementable _Winc,
642 semiregular _Bound = unreachable_sentinel_t>
643 requires std::__detail::__weakly_eq_cmp_with<_Winc, _Bound>
644 class iota_view :
public view_interface<iota_view<_Winc, _Bound>>
653 using namespace __detail;
654 if constexpr (__advanceable<_Winc>)
655 return random_access_iterator_tag{};
656 else if constexpr (__decrementable<_Winc>)
657 return bidirectional_iterator_tag{};
658 else if constexpr (incrementable<_Winc>)
659 return forward_iterator_tag{};
661 return input_iterator_tag{};
665 using iterator_category = decltype(_S_iter_cat());
666 using value_type = _Winc;
667 using difference_type = __detail::__iota_diff_t<_Winc>;
669 _Iterator() =
default;
672 _Iterator(_Winc __value)
673 : _M_value(__value) { }
676 operator*() const noexcept(is_nothrow_copy_constructible_v<_Winc>)
691 operator++(
int) requires incrementable<_Winc>
699 operator--() requires __detail::__decrementable<_Winc>
706 operator--(
int) requires __detail::__decrementable<_Winc>
714 operator+=(difference_type __n) requires __detail::__advanceable<_Winc>
716 using __detail::__is_integer_like;
717 using __detail::__is_signed_integer_like;
718 if constexpr (__is_integer_like<_Winc>
719 && !__is_signed_integer_like<_Winc>)
721 if (__n >= difference_type(0))
722 _M_value += static_cast<_Winc>(__n);
724 _M_value -= static_cast<_Winc>(-__n);
732 operator-=(difference_type __n) requires __detail::__advanceable<_Winc>
734 using __detail::__is_integer_like;
735 using __detail::__is_signed_integer_like;
736 if constexpr (__is_integer_like<_Winc>
737 && !__is_signed_integer_like<_Winc>)
739 if (__n >= difference_type(0))
740 _M_value -= static_cast<_Winc>(__n);
742 _M_value += static_cast<_Winc>(-__n);
750 operator[](difference_type __n)
const
751 requires __detail::__advanceable<_Winc>
752 {
return _Winc(_M_value + __n); }
754 friend constexpr
bool
755 operator==(
const _Iterator& __x,
const _Iterator& __y)
756 requires equality_comparable<_Winc>
757 {
return __x._M_value == __y._M_value; }
759 friend constexpr
bool
760 operator<(
const _Iterator& __x,
const _Iterator& __y)
761 requires totally_ordered<_Winc>
762 {
return __x._M_value < __y._M_value; }
764 friend constexpr
bool
765 operator>(
const _Iterator& __x,
const _Iterator& __y)
766 requires totally_ordered<_Winc>
767 {
return __y < __x; }
769 friend constexpr
bool
770 operator<=(
const _Iterator& __x,
const _Iterator& __y)
771 requires totally_ordered<_Winc>
772 {
return !(__y < __x); }
774 friend constexpr
bool
775 operator>=(
const _Iterator& __x,
const _Iterator& __y)
776 requires totally_ordered<_Winc>
777 {
return !(__x < __y); }
779 #ifdef __cpp_lib_threeway_comparison
780 friend constexpr compare_three_way_result_t<_Winc>
781 operator<=>(
const _Iterator& __x,
const _Iterator& __y)
782 requires totally_ordered<_Winc> && three_way_comparable<_Winc>
783 {
return __x._M_value <=> __y._M_value; }
786 friend constexpr _Iterator
787 operator+(_Iterator __i, difference_type __n)
788 requires __detail::__advanceable<_Winc>
789 {
return __i += __n; }
791 friend constexpr _Iterator
792 operator+(difference_type __n, _Iterator __i)
793 requires __detail::__advanceable<_Winc>
794 {
return __i += __n; }
796 friend constexpr _Iterator
797 operator-(_Iterator __i, difference_type __n)
798 requires __detail::__advanceable<_Winc>
799 {
return __i -= __n; }
801 friend constexpr difference_type
802 operator-(
const _Iterator& __x,
const _Iterator& __y)
803 requires __detail::__advanceable<_Winc>
805 using __detail::__is_integer_like;
806 using __detail::__is_signed_integer_like;
807 using _Dt = difference_type;
808 if constexpr (__is_integer_like<_Winc>)
810 if constexpr (__is_signed_integer_like<_Winc>)
811 return _Dt(_Dt(__x._M_value) - _Dt(__y._M_value));
813 return (__y._M_value > __x._M_value)
814 ? _Dt(-_Dt(__y._M_value - __x._M_value))
815 : _Dt(__x._M_value - __y._M_value);
818 return __x._M_value - __y._M_value;
822 _Winc _M_value = _Winc();
828 _Bound _M_bound = _Bound();
831 _Sentinel() =
default;
834 _Sentinel(_Bound __bound)
835 : _M_bound(__bound) { }
837 friend constexpr
bool
838 operator==(
const _Iterator& __x,
const _Sentinel& __y)
839 {
return __x._M_value == __y._M_bound; }
841 friend constexpr iter_difference_t<_Winc>
842 operator-(
const _Iterator& __x,
const _Sentinel& __y)
843 requires sized_sentinel_for<_Bound, _Winc>
844 {
return __x._M_value - __y._M_bound; }
846 friend constexpr iter_difference_t<_Winc>
847 operator-(
const _Sentinel& __x,
const _Iterator& __y)
848 requires sized_sentinel_for<_Bound, _Winc>
849 {
return -(__y - __x); }
852 _Winc _M_value = _Winc();
853 _Bound _M_bound = _Bound();
856 iota_view() =
default;
859 iota_view(_Winc __value)
864 iota_view(type_identity_t<_Winc> __value,
865 type_identity_t<_Bound> __bound)
866 : _M_value(__value), _M_bound(__bound)
868 if constexpr (totally_ordered_with<_Winc, _Bound>)
869 __glibcxx_assert(
bool(__value <= __bound) );
873 begin()
const {
return _Iterator{_M_value}; }
878 if constexpr (same_as<_Bound, unreachable_sentinel_t>)
879 return unreachable_sentinel;
881 return _Sentinel{_M_bound};
885 end() const requires same_as<_Winc, _Bound>
886 {
return _Iterator{_M_bound}; }
890 requires (same_as<_Winc, _Bound> && __detail::__advanceable<_Winc>)
891 || (integral<_Winc> && integral<_Bound>)
892 || sized_sentinel_for<_Bound, _Winc>
894 using __detail::__is_integer_like;
895 using __detail::__to_unsigned_like;
896 if constexpr (__is_integer_like<_Winc> && __is_integer_like<_Bound>)
897 return (_M_value < 0)
899 ? __to_unsigned_like(-_M_value) - __to_unsigned_like(-_M_bound)
900 : __to_unsigned_like(_M_bound) + __to_unsigned_like(-_M_value))
901 : __to_unsigned_like(_M_bound) - __to_unsigned_like(_M_value);
903 return __to_unsigned_like(_M_bound - _M_value);
907 template<
typename _Winc,
typename _Bound>
908 requires (!__detail::__is_integer_like<_Winc>
909 || !__detail::__is_integer_like<_Bound>
910 || (__detail::__is_signed_integer_like<_Winc>
911 == __detail::__is_signed_integer_like<_Bound>))
912 iota_view(_Winc, _Bound) -> iota_view<_Winc, _Bound>;
914 template<weakly_incrementable _Winc, semiregular _Bound>
915 inline constexpr
bool enable_safe_range<iota_view<_Winc, _Bound>> =
true;
919 template<
typename _Tp>
920 inline constexpr empty_view<_Tp> empty{};
924 template<
typename _Tp>
926 operator()(_Tp&& __e)
const
927 {
return single_view{std::forward<_Tp>(__e)}; }
930 inline constexpr _Single single{};
934 template<
typename _Tp>
936 operator()(_Tp&& __e)
const
937 {
return iota_view{std::forward<_Tp>(__e)}; }
939 template<
typename _Tp,
typename _Up>
941 operator()(_Tp&& __e, _Up&& __f)
const
942 {
return iota_view{std::forward<_Tp>(__e), std::forward<_Tp>(__f)}; }
945 inline constexpr _Iota
iota{};
949 _GLIBCXX_END_NAMESPACE_VERSION
951 #endif // library concepts