// Core concepts and definitions for -*- C++ -*- // Copyright (C) 2019-2020 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the // terms of the GNU General Public License as published by the // Free Software Foundation; either version 3, or (at your option) // any later version. // This library is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // Under Section 7 of GPL version 3, you are granted additional // permissions described in the GCC Runtime Library Exception, version // 3.1, as published by the Free Software Foundation. // You should have received a copy of the GNU General Public License and // a copy of the GCC Runtime Library Exception along with this program; // see the files COPYING3 and COPYING.RUNTIME respectively. If not, see // . /** @file bits/ranges_base.h * This is an internal header file, included by other library headers. * Do not attempt to use it directly. @headername{ranges} */ #ifndef _GLIBCXX_RANGES_BASE_H #define _GLIBCXX_RANGES_BASE_H 1 #pragma GCC system_header #if __cplusplus > 201703L #include #include #include #ifdef __cpp_lib_concepts namespace std _GLIBCXX_VISIBILITY(default) { _GLIBCXX_BEGIN_NAMESPACE_VERSION namespace ranges { template inline constexpr bool disable_sized_range = false; template inline constexpr bool enable_borrowed_range = false; namespace __detail { constexpr __max_size_type __to_unsigned_like(__max_size_type __t) noexcept { return __t; } constexpr __max_size_type __to_unsigned_like(__max_diff_type __t) noexcept { return __max_size_type(__t); } template constexpr auto __to_unsigned_like(_Tp __t) noexcept { return static_cast>(__t); } #if defined __STRICT_ANSI__ && defined __SIZEOF_INT128__ constexpr unsigned __int128 __to_unsigned_like(__int128 __t) noexcept { return __t; } constexpr unsigned __int128 __to_unsigned_like(unsigned __int128 __t) noexcept { return __t; } #endif template using __make_unsigned_like_t = decltype(__detail::__to_unsigned_like(std::declval<_Tp>())); // Part of the constraints of ranges::borrowed_range template concept __maybe_borrowed_range = is_lvalue_reference_v<_Tp> || enable_borrowed_range>; } // namespace __detail namespace __cust_access { using std::ranges::__detail::__maybe_borrowed_range; using std::__detail::__class_or_enum; using std::__detail::__decay_copy; using std::__detail::__member_begin; using std::__detail::__adl_begin; struct _Begin { private: template static constexpr bool _S_noexcept() { if constexpr (is_array_v>) return true; else if constexpr (__member_begin<_Tp>) return noexcept(__decay_copy(std::declval<_Tp&>().begin())); else return noexcept(__decay_copy(begin(std::declval<_Tp&>()))); } public: template<__maybe_borrowed_range _Tp> requires is_array_v> || __member_begin<_Tp> || __adl_begin<_Tp> constexpr auto operator()(_Tp&& __t) const noexcept(_S_noexcept<_Tp>()) { if constexpr (is_array_v>) { static_assert(is_lvalue_reference_v<_Tp>); using _Up = remove_all_extents_t>; static_assert(sizeof(_Up) != 0, "not array of incomplete type"); return __t + 0; } else if constexpr (__member_begin<_Tp>) return __t.begin(); else return begin(__t); } }; template concept __member_end = requires(_Tp& __t) { { __decay_copy(__t.end()) } -> sentinel_for(__t)))>; }; void end(auto&) = delete; void end(const auto&) = delete; template concept __adl_end = __class_or_enum> && requires(_Tp& __t) { { __decay_copy(end(__t)) } -> sentinel_for(__t)))>; }; struct _End { private: template static constexpr bool _S_noexcept() { if constexpr (is_bounded_array_v>) return true; else if constexpr (__member_end<_Tp>) return noexcept(__decay_copy(std::declval<_Tp&>().end())); else return noexcept(__decay_copy(end(std::declval<_Tp&>()))); } public: template<__maybe_borrowed_range _Tp> requires is_bounded_array_v> || __member_end<_Tp> || __adl_end<_Tp> constexpr auto operator()(_Tp&& __t) const noexcept(_S_noexcept<_Tp>()) { if constexpr (is_bounded_array_v>) { static_assert(is_lvalue_reference_v<_Tp>); return __t + extent_v>; } else if constexpr (__member_end<_Tp>) return __t.end(); else return end(__t); } }; template constexpr decltype(auto) __as_const(_Tp&& __t) noexcept { if constexpr (is_lvalue_reference_v<_Tp>) return static_cast&>(__t); else return static_cast(__t); } struct _CBegin { template constexpr auto operator()(_Tp&& __e) const noexcept(noexcept(_Begin{}(__cust_access::__as_const((_Tp&&)__e)))) requires requires { _Begin{}(__cust_access::__as_const((_Tp&&)__e)); } { return _Begin{}(__cust_access::__as_const(std::forward<_Tp>(__e))); } }; struct _CEnd { template constexpr auto operator()(_Tp&& __e) const noexcept(noexcept(_End{}(__cust_access::__as_const((_Tp&&)__e)))) requires requires { _End{}(__cust_access::__as_const((_Tp&&)__e)); } { return _End{}(__cust_access::__as_const(std::forward<_Tp>(__e))); } }; template concept __member_rbegin = requires(_Tp& __t) { { __decay_copy(__t.rbegin()) } -> input_or_output_iterator; }; void rbegin(auto&) = delete; void rbegin(const auto&) = delete; template concept __adl_rbegin = __class_or_enum> && requires(_Tp& __t) { { __decay_copy(rbegin(__t)) } -> input_or_output_iterator; }; template concept __reversable = requires(_Tp& __t) { { _Begin{}(__t) } -> bidirectional_iterator; { _End{}(__t) } -> same_as; }; struct _RBegin { private: template static constexpr bool _S_noexcept() { if constexpr (__member_rbegin<_Tp>) return noexcept(__decay_copy(std::declval<_Tp&>().rbegin())); else if constexpr (__adl_rbegin<_Tp>) return noexcept(__decay_copy(rbegin(std::declval<_Tp&>()))); else { if constexpr (noexcept(_End{}(std::declval<_Tp&>()))) { using _It = decltype(_End{}(std::declval<_Tp&>())); // std::reverse_iterator copy-initializes its member. return is_nothrow_copy_constructible_v<_It>; } else return false; } } public: template<__maybe_borrowed_range _Tp> requires __member_rbegin<_Tp> || __adl_rbegin<_Tp> || __reversable<_Tp> constexpr auto operator()(_Tp&& __t) const noexcept(_S_noexcept<_Tp>()) { if constexpr (__member_rbegin<_Tp>) return __t.rbegin(); else if constexpr (__adl_rbegin<_Tp>) return rbegin(__t); else return std::make_reverse_iterator(_End{}(__t)); } }; template concept __member_rend = requires(_Tp& __t) { { __decay_copy(__t.rend()) } -> sentinel_for; }; void rend(auto&) = delete; void rend(const auto&) = delete; template concept __adl_rend = __class_or_enum> && requires(_Tp& __t) { { __decay_copy(rend(__t)) } -> sentinel_for(__t)))>; }; struct _REnd { private: template static constexpr bool _S_noexcept() { if constexpr (__member_rend<_Tp>) return noexcept(__decay_copy(std::declval<_Tp&>().rend())); else if constexpr (__adl_rend<_Tp>) return noexcept(__decay_copy(rend(std::declval<_Tp&>()))); else { if constexpr (noexcept(_Begin{}(std::declval<_Tp&>()))) { using _It = decltype(_Begin{}(std::declval<_Tp&>())); // std::reverse_iterator copy-initializes its member. return is_nothrow_copy_constructible_v<_It>; } else return false; } } public: template<__maybe_borrowed_range _Tp> requires __member_rend<_Tp> || __adl_rend<_Tp> || __reversable<_Tp> constexpr auto operator()(_Tp&& __t) const noexcept(_S_noexcept<_Tp>()) { if constexpr (__member_rend<_Tp>) return __t.rend(); else if constexpr (__adl_rend<_Tp>) return rend(__t); else return std::make_reverse_iterator(_Begin{}(__t)); } }; struct _CRBegin { template constexpr auto operator()(_Tp&& __e) const noexcept(noexcept(_RBegin{}(__cust_access::__as_const((_Tp&&)__e)))) requires requires { _RBegin{}(__cust_access::__as_const((_Tp&&)__e)); } { return _RBegin{}(__cust_access::__as_const(std::forward<_Tp>(__e))); } }; struct _CREnd { template constexpr auto operator()(_Tp&& __e) const noexcept(noexcept(_REnd{}(__cust_access::__as_const((_Tp&&)__e)))) requires requires { _REnd{}(__cust_access::__as_const((_Tp&&)__e)); } { return _REnd{}(__cust_access::__as_const(std::forward<_Tp>(__e))); } }; template concept __member_size = !disable_sized_range> && requires(_Tp&& __t) { { __decay_copy(std::forward<_Tp>(__t).size()) } -> __detail::__is_integer_like; }; void size(auto&) = delete; void size(const auto&) = delete; template concept __adl_size = __class_or_enum> && !disable_sized_range> && requires(_Tp&& __t) { { __decay_copy(size(std::forward<_Tp>(__t))) } -> __detail::__is_integer_like; }; template concept __sentinel_size = requires(_Tp&& __t) { { _Begin{}(std::forward<_Tp>(__t)) } -> forward_iterator; { _End{}(std::forward<_Tp>(__t)) } -> sized_sentinel_for(__t)))>; }; struct _Size { private: template static constexpr bool _S_noexcept() { if constexpr (is_bounded_array_v>) return true; else if constexpr (__member_size<_Tp>) return noexcept(__decay_copy(std::declval<_Tp>().size())); else if constexpr (__adl_size<_Tp>) return noexcept(__decay_copy(size(std::declval<_Tp>()))); else if constexpr (__sentinel_size<_Tp>) return noexcept(_End{}(std::declval<_Tp>()) - _Begin{}(std::declval<_Tp>())); } public: template requires is_bounded_array_v> || __member_size<_Tp> || __adl_size<_Tp> || __sentinel_size<_Tp> constexpr auto operator()(_Tp&& __e) const noexcept(_S_noexcept<_Tp>()) { if constexpr (is_bounded_array_v>) { return extent_v>; } else if constexpr (__member_size<_Tp>) return std::forward<_Tp>(__e).size(); else if constexpr (__adl_size<_Tp>) return size(std::forward<_Tp>(__e)); else if constexpr (__sentinel_size<_Tp>) return __detail::__to_unsigned_like( _End{}(std::forward<_Tp>(__e)) - _Begin{}(std::forward<_Tp>(__e))); } }; struct _SSize { template requires requires (_Tp&& __e) { _Begin{}(std::forward<_Tp>(__e)); _Size{}(std::forward<_Tp>(__e)); } constexpr auto operator()(_Tp&& __e) const noexcept(noexcept(_Size{}(std::forward<_Tp>(__e)))) { using __iter_type = decltype(_Begin{}(std::forward<_Tp>(__e))); using __diff_type = iter_difference_t<__iter_type>; using __gnu_cxx::__int_traits; auto __size = _Size{}(std::forward<_Tp>(__e)); if constexpr (integral<__diff_type>) { if constexpr (__int_traits<__diff_type>::__digits < __int_traits::__digits) return static_cast(__size); } return static_cast<__diff_type>(__size); } }; template concept __member_empty = requires(_Tp&& __t) { bool(std::forward<_Tp>(__t).empty()); }; template concept __size0_empty = requires(_Tp&& __t) { _Size{}(std::forward<_Tp>(__t)) == 0; }; template concept __eq_iter_empty = requires(_Tp&& __t) { { _Begin{}(std::forward<_Tp>(__t)) } -> forward_iterator; bool(_Begin{}(std::forward<_Tp>(__t)) == _End{}(std::forward<_Tp>(__t))); }; struct _Empty { private: template static constexpr bool _S_noexcept() { if constexpr (__member_empty<_Tp>) return noexcept(std::declval<_Tp>().empty()); else if constexpr (__size0_empty<_Tp>) return noexcept(_Size{}(std::declval<_Tp>()) == 0); else return noexcept(bool(_Begin{}(std::declval<_Tp>()) == _End{}(std::declval<_Tp>()))); } public: template requires __member_empty<_Tp> || __size0_empty<_Tp> || __eq_iter_empty<_Tp> constexpr bool operator()(_Tp&& __e) const noexcept(_S_noexcept<_Tp>()) { if constexpr (__member_empty<_Tp>) return bool(std::forward<_Tp>(__e).empty()); else if constexpr (__size0_empty<_Tp>) return _Size{}(std::forward<_Tp>(__e)) == 0; else return bool(_Begin{}(std::forward<_Tp>(__e)) == _End{}(std::forward<_Tp>(__e))); } }; template concept __pointer_to_object = is_pointer_v<_Tp> && is_object_v>; template concept __member_data = is_lvalue_reference_v<_Tp> && requires(_Tp __t) { { __t.data() } -> __pointer_to_object; }; template concept __begin_data = requires(_Tp&& __t) { { _Begin{}(std::forward<_Tp>(__t)) } -> contiguous_iterator; }; struct _Data { private: template static constexpr bool _S_noexcept() { if constexpr (__member_data<_Tp>) return noexcept(__decay_copy(std::declval<_Tp>().data())); else return noexcept(_Begin{}(std::declval<_Tp>())); } public: template<__maybe_borrowed_range _Tp> requires __member_data<_Tp> || __begin_data<_Tp> constexpr auto operator()(_Tp&& __e) const noexcept(_S_noexcept<_Tp>()) { if constexpr (__member_data<_Tp>) return __e.data(); else return std::to_address(_Begin{}(std::forward<_Tp>(__e))); } }; struct _CData { template constexpr auto operator()(_Tp&& __e) const noexcept(noexcept(_Data{}(__cust_access::__as_const((_Tp&&)__e)))) requires requires { _Data{}(__cust_access::__as_const((_Tp&&)__e)); } { return _Data{}(__cust_access::__as_const(std::forward<_Tp>(__e))); } }; } // namespace __cust_access inline namespace __cust { inline constexpr __cust_access::_Begin begin{}; inline constexpr __cust_access::_End end{}; inline constexpr __cust_access::_CBegin cbegin{}; inline constexpr __cust_access::_CEnd cend{}; inline constexpr __cust_access::_RBegin rbegin{}; inline constexpr __cust_access::_REnd rend{}; inline constexpr __cust_access::_CRBegin crbegin{}; inline constexpr __cust_access::_CREnd crend{}; inline constexpr __cust_access::_Size size{}; inline constexpr __cust_access::_SSize ssize{}; inline constexpr __cust_access::_Empty empty{}; inline constexpr __cust_access::_Data data{}; inline constexpr __cust_access::_CData cdata{}; } /// [range.range] The range concept. template concept range = requires(_Tp& __t) { ranges::begin(__t); ranges::end(__t); }; /// [range.range] The borrowed_range concept. template concept borrowed_range = range<_Tp> && __detail::__maybe_borrowed_range<_Tp>; template using iterator_t = std::__detail::__range_iter_t<_Tp>; template using sentinel_t = decltype(ranges::end(std::declval<_Range&>())); template using range_difference_t = iter_difference_t>; template using range_value_t = iter_value_t>; template using range_reference_t = iter_reference_t>; template using range_rvalue_reference_t = iter_rvalue_reference_t>; /// [range.sized] The sized_range concept. template concept sized_range = range<_Tp> && requires(_Tp& __t) { ranges::size(__t); }; template using range_size_t = decltype(ranges::size(std::declval<_Range&>())); /// [range.view] The ranges::view_base type. struct view_base { }; /// [range.view] The ranges::enable_view boolean. template inline constexpr bool enable_view = derived_from<_Tp, view_base>; /// [range.view] The ranges::view concept. template concept view = range<_Tp> && movable<_Tp> && default_initializable<_Tp> && enable_view<_Tp>; // [range.refinements] /// A range for which ranges::begin returns an output iterator. template concept output_range = range<_Range> && output_iterator, _Tp>; /// A range for which ranges::begin returns an input iterator. template concept input_range = range<_Tp> && input_iterator>; /// A range for which ranges::begin returns a forward iterator. template concept forward_range = input_range<_Tp> && forward_iterator>; /// A range for which ranges::begin returns a bidirectional iterator. template concept bidirectional_range = forward_range<_Tp> && bidirectional_iterator>; /// A range for which ranges::begin returns a random access iterator. template concept random_access_range = bidirectional_range<_Tp> && random_access_iterator>; /// A range for which ranges::begin returns a contiguous iterator. template concept contiguous_range = random_access_range<_Tp> && contiguous_iterator> && requires(_Tp& __t) { { ranges::data(__t) } -> same_as>>; }; /// A range for which ranges::begin and ranges::end return the same type. template concept common_range = range<_Tp> && same_as, sentinel_t<_Tp>>; /// A range which can be safely converted to a view. template concept viewable_range = range<_Tp> && (borrowed_range<_Tp> || view>); // [range.iter.ops] range iterator operations template constexpr void advance(_It& __it, iter_difference_t<_It> __n) { if constexpr (random_access_iterator<_It>) __it += __n; else if constexpr (bidirectional_iterator<_It>) { if (__n > 0) { do { ++__it; } while (--__n); } else if (__n < 0) { do { --__it; } while (++__n); } } else { // cannot decrement a non-bidirectional iterator __glibcxx_assert(__n >= 0); while (__n-- > 0) ++__it; } } template _Sent> constexpr void advance(_It& __it, _Sent __bound) { if constexpr (assignable_from<_It&, _Sent>) __it = std::move(__bound); else if constexpr (sized_sentinel_for<_Sent, _It>) ranges::advance(__it, __bound - __it); else { while (__it != __bound) ++__it; } } template _Sent> constexpr iter_difference_t<_It> advance(_It& __it, iter_difference_t<_It> __n, _Sent __bound) { if constexpr (sized_sentinel_for<_Sent, _It>) { const auto __diff = __bound - __it; #ifdef __cpp_lib_is_constant_evaluated if (std::is_constant_evaluated() && !(__n == 0 || __diff == 0 || (__n < 0 == __diff < 0))) throw "inconsistent directions for distance and bound"; #endif // n and bound must not lead in opposite directions: __glibcxx_assert(__n == 0 || __diff == 0 || (__n < 0 == __diff < 0)); const auto __absdiff = __diff < 0 ? -__diff : __diff; const auto __absn = __n < 0 ? -__n : __n;; if (__absn >= __absdiff) { ranges::advance(__it, __bound); return __n - __diff; } else { ranges::advance(__it, __n); return 0; } } else if (__it == __bound || __n == 0) return iter_difference_t<_It>(0); else if (__n > 0) { iter_difference_t<_It> __m = 0; do { ++__it; ++__m; } while (__m != __n && __it != __bound); return __n - __m; } else if constexpr (bidirectional_iterator<_It> && same_as<_It, _Sent>) { iter_difference_t<_It> __m = 0; do { --__it; --__m; } while (__m != __n && __it != __bound); return __n - __m; } else { // cannot decrement a non-bidirectional iterator __glibcxx_assert(__n >= 0); return __n; } } template _Sent> constexpr iter_difference_t<_It> distance(_It __first, _Sent __last) { if constexpr (sized_sentinel_for<_Sent, _It>) return __last - __first; else { iter_difference_t<_It> __n = 0; while (__first != __last) { ++__first; ++__n; } return __n; } } template constexpr range_difference_t<_Range> distance(_Range&& __r) { if constexpr (sized_range<_Range>) return static_cast>(ranges::size(__r)); else return ranges::distance(ranges::begin(__r), ranges::end(__r)); } template constexpr _It next(_It __x) { ++__x; return __x; } template constexpr _It next(_It __x, iter_difference_t<_It> __n) { ranges::advance(__x, __n); return __x; } template _Sent> constexpr _It next(_It __x, _Sent __bound) { ranges::advance(__x, __bound); return __x; } template _Sent> constexpr _It next(_It __x, iter_difference_t<_It> __n, _Sent __bound) { ranges::advance(__x, __n, __bound); return __x; } template constexpr _It prev(_It __x) { --__x; return __x; } template constexpr _It prev(_It __x, iter_difference_t<_It> __n) { ranges::advance(__x, -__n); return __x; } template constexpr _It prev(_It __x, iter_difference_t<_It> __n, _It __bound) { ranges::advance(__x, -__n, __bound); return __x; } /// Type returned by algorithms instead of a dangling iterator or subrange. struct dangling { constexpr dangling() noexcept = default; template constexpr dangling(_Args&&...) noexcept { } }; template using borrowed_iterator_t = conditional_t, iterator_t<_Range>, dangling>; } // namespace ranges _GLIBCXX_END_NAMESPACE_VERSION } // namespace std #endif // library concepts #endif // C++20 #endif // _GLIBCXX_RANGES_BASE_H