access.h 6.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225
  1. // -*- C++ -*-
  2. //===----------------------------------------------------------------------===//
  3. //
  4. // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
  5. // See https://llvm.org/LICENSE.txt for license information.
  6. // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
  7. //
  8. //===----------------------------------------------------------------------===//
  9. #ifndef _LIBCPP___RANGES_ACCESS_H
  10. #define _LIBCPP___RANGES_ACCESS_H
  11. #include <__concepts/class_or_enum.h>
  12. #include <__config>
  13. #include <__iterator/concepts.h>
  14. #include <__iterator/readable_traits.h>
  15. #include <__ranges/enable_borrowed_range.h>
  16. #include <__utility/auto_cast.h>
  17. #include <type_traits>
  18. #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
  19. # pragma GCC system_header
  20. #endif
  21. _LIBCPP_BEGIN_NAMESPACE_STD
  22. #if !defined(_LIBCPP_HAS_NO_CONCEPTS)
  23. namespace ranges {
  24. template <class _Tp>
  25. concept __can_borrow =
  26. is_lvalue_reference_v<_Tp> || enable_borrowed_range<remove_cvref_t<_Tp>>;
  27. } // namespace ranges
  28. // [range.access.begin]
  29. namespace ranges {
  30. namespace __begin {
  31. template <class _Tp>
  32. concept __member_begin =
  33. __can_borrow<_Tp> &&
  34. __workaround_52970<_Tp> &&
  35. requires(_Tp&& __t) {
  36. { _LIBCPP_AUTO_CAST(__t.begin()) } -> input_or_output_iterator;
  37. };
  38. void begin(auto&) = delete;
  39. void begin(const auto&) = delete;
  40. template <class _Tp>
  41. concept __unqualified_begin =
  42. !__member_begin<_Tp> &&
  43. __can_borrow<_Tp> &&
  44. __class_or_enum<remove_cvref_t<_Tp>> &&
  45. requires(_Tp && __t) {
  46. { _LIBCPP_AUTO_CAST(begin(__t)) } -> input_or_output_iterator;
  47. };
  48. struct __fn {
  49. template <class _Tp>
  50. [[nodiscard]] _LIBCPP_HIDE_FROM_ABI constexpr auto operator()(_Tp (&__t)[]) const noexcept
  51. requires (sizeof(_Tp) != 0) // Disallow incomplete element types.
  52. {
  53. return __t + 0;
  54. }
  55. template <class _Tp, size_t _Np>
  56. [[nodiscard]] _LIBCPP_HIDE_FROM_ABI constexpr auto operator()(_Tp (&__t)[_Np]) const noexcept
  57. requires (sizeof(_Tp) != 0) // Disallow incomplete element types.
  58. {
  59. return __t + 0;
  60. }
  61. template <class _Tp>
  62. requires __member_begin<_Tp>
  63. [[nodiscard]] _LIBCPP_HIDE_FROM_ABI constexpr auto operator()(_Tp&& __t) const
  64. noexcept(noexcept(_LIBCPP_AUTO_CAST(__t.begin())))
  65. {
  66. return _LIBCPP_AUTO_CAST(__t.begin());
  67. }
  68. template <class _Tp>
  69. requires __unqualified_begin<_Tp>
  70. [[nodiscard]] _LIBCPP_HIDE_FROM_ABI constexpr auto operator()(_Tp&& __t) const
  71. noexcept(noexcept(_LIBCPP_AUTO_CAST(begin(__t))))
  72. {
  73. return _LIBCPP_AUTO_CAST(begin(__t));
  74. }
  75. void operator()(auto&&) const = delete;
  76. };
  77. } // namespace __begin
  78. inline namespace __cpo {
  79. inline constexpr auto begin = __begin::__fn{};
  80. } // namespace __cpo
  81. } // namespace ranges
  82. // [range.range]
  83. namespace ranges {
  84. template <class _Tp>
  85. using iterator_t = decltype(ranges::begin(declval<_Tp&>()));
  86. } // namespace ranges
  87. // [range.access.end]
  88. namespace ranges {
  89. namespace __end {
  90. template <class _Tp>
  91. concept __member_end =
  92. __can_borrow<_Tp> &&
  93. __workaround_52970<_Tp> &&
  94. requires(_Tp&& __t) {
  95. typename iterator_t<_Tp>;
  96. { _LIBCPP_AUTO_CAST(__t.end()) } -> sentinel_for<iterator_t<_Tp>>;
  97. };
  98. void end(auto&) = delete;
  99. void end(const auto&) = delete;
  100. template <class _Tp>
  101. concept __unqualified_end =
  102. !__member_end<_Tp> &&
  103. __can_borrow<_Tp> &&
  104. __class_or_enum<remove_cvref_t<_Tp>> &&
  105. requires(_Tp && __t) {
  106. typename iterator_t<_Tp>;
  107. { _LIBCPP_AUTO_CAST(end(__t)) } -> sentinel_for<iterator_t<_Tp>>;
  108. };
  109. class __fn {
  110. public:
  111. template <class _Tp, size_t _Np>
  112. [[nodiscard]] _LIBCPP_HIDE_FROM_ABI constexpr auto operator()(_Tp (&__t)[_Np]) const noexcept
  113. requires (sizeof(_Tp) != 0) // Disallow incomplete element types.
  114. {
  115. return __t + _Np;
  116. }
  117. template <class _Tp>
  118. requires __member_end<_Tp>
  119. [[nodiscard]] _LIBCPP_HIDE_FROM_ABI constexpr auto operator()(_Tp&& __t) const
  120. noexcept(noexcept(_LIBCPP_AUTO_CAST(__t.end())))
  121. {
  122. return _LIBCPP_AUTO_CAST(__t.end());
  123. }
  124. template <class _Tp>
  125. requires __unqualified_end<_Tp>
  126. [[nodiscard]] _LIBCPP_HIDE_FROM_ABI constexpr auto operator()(_Tp&& __t) const
  127. noexcept(noexcept(_LIBCPP_AUTO_CAST(end(__t))))
  128. {
  129. return _LIBCPP_AUTO_CAST(end(__t));
  130. }
  131. void operator()(auto&&) const = delete;
  132. };
  133. } // namespace __end
  134. inline namespace __cpo {
  135. inline constexpr auto end = __end::__fn{};
  136. } // namespace __cpo
  137. } // namespace ranges
  138. // [range.access.cbegin]
  139. namespace ranges {
  140. namespace __cbegin {
  141. struct __fn {
  142. template <class _Tp>
  143. requires is_lvalue_reference_v<_Tp&&>
  144. [[nodiscard]] _LIBCPP_HIDE_FROM_ABI
  145. constexpr auto operator()(_Tp&& __t) const
  146. noexcept(noexcept(ranges::begin(static_cast<const remove_reference_t<_Tp>&>(__t))))
  147. -> decltype( ranges::begin(static_cast<const remove_reference_t<_Tp>&>(__t)))
  148. { return ranges::begin(static_cast<const remove_reference_t<_Tp>&>(__t)); }
  149. template <class _Tp>
  150. requires is_rvalue_reference_v<_Tp&&>
  151. [[nodiscard]] _LIBCPP_HIDE_FROM_ABI
  152. constexpr auto operator()(_Tp&& __t) const
  153. noexcept(noexcept(ranges::begin(static_cast<const _Tp&&>(__t))))
  154. -> decltype( ranges::begin(static_cast<const _Tp&&>(__t)))
  155. { return ranges::begin(static_cast<const _Tp&&>(__t)); }
  156. };
  157. } // namespace __cbegin
  158. inline namespace __cpo {
  159. inline constexpr auto cbegin = __cbegin::__fn{};
  160. } // namespace __cpo
  161. } // namespace ranges
  162. // [range.access.cend]
  163. namespace ranges {
  164. namespace __cend {
  165. struct __fn {
  166. template <class _Tp>
  167. requires is_lvalue_reference_v<_Tp&&>
  168. [[nodiscard]] _LIBCPP_HIDE_FROM_ABI
  169. constexpr auto operator()(_Tp&& __t) const
  170. noexcept(noexcept(ranges::end(static_cast<const remove_reference_t<_Tp>&>(__t))))
  171. -> decltype( ranges::end(static_cast<const remove_reference_t<_Tp>&>(__t)))
  172. { return ranges::end(static_cast<const remove_reference_t<_Tp>&>(__t)); }
  173. template <class _Tp>
  174. requires is_rvalue_reference_v<_Tp&&>
  175. [[nodiscard]] _LIBCPP_HIDE_FROM_ABI
  176. constexpr auto operator()(_Tp&& __t) const
  177. noexcept(noexcept(ranges::end(static_cast<const _Tp&&>(__t))))
  178. -> decltype( ranges::end(static_cast<const _Tp&&>(__t)))
  179. { return ranges::end(static_cast<const _Tp&&>(__t)); }
  180. };
  181. } // namespace __cend
  182. inline namespace __cpo {
  183. inline constexpr auto cend = __cend::__fn{};
  184. } // namespace __cpo
  185. } // namespace ranges
  186. #endif // !defined(_LIBCPP_HAS_NO_CONCEPTS)
  187. _LIBCPP_END_NAMESPACE_STD
  188. #endif // _LIBCPP___RANGES_ACCESS_H