ranges 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400
  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
  10. #define _LIBCPP_RANGES
  11. /*
  12. #include <compare> // see [compare.syn]
  13. #include <initializer_list> // see [initializer.list.syn]
  14. #include <iterator> // see [iterator.synopsis]
  15. namespace std::ranges {
  16. inline namespace unspecified {
  17. // [range.access], range access
  18. inline constexpr unspecified begin = unspecified;
  19. inline constexpr unspecified end = unspecified;
  20. inline constexpr unspecified cbegin = unspecified;
  21. inline constexpr unspecified cend = unspecified;
  22. inline constexpr unspecified size = unspecified;
  23. inline constexpr unspecified ssize = unspecified;
  24. }
  25. // [range.range], ranges
  26. template<class T>
  27. concept range = see below;
  28. template<class T>
  29. inline constexpr bool enable_borrowed_range = false;
  30. template<class T>
  31. using iterator_t = decltype(ranges::begin(declval<T&>()));
  32. template<range R>
  33. using sentinel_t = decltype(ranges::end(declval<R&>()));
  34. template<range R>
  35. using range_difference_t = iter_difference_t<iterator_t<R>>;
  36. template<sized_range R>
  37. using range_size_t = decltype(ranges::size(declval<R&>()));
  38. template<range R>
  39. using range_value_t = iter_value_t<iterator_t<R>>;
  40. template<range R>
  41. using range_reference_t = iter_reference_t<iterator_t<R>>;
  42. template<range R>
  43. using range_rvalue_reference_t = iter_rvalue_reference_t<iterator_t<R>>;
  44. // [range.sized], sized ranges
  45. template<class>
  46. inline constexpr bool disable_sized_range = false;
  47. template<class T>
  48. concept sized_range = ...;
  49. // [range.view], views
  50. template<class T>
  51. inline constexpr bool enable_view = ...;
  52. struct view_base { };
  53. template<class T>
  54. concept view = ...;
  55. // [range.refinements], other range refinements
  56. template<class R, class T>
  57. concept output_range = see below;
  58. template<class T>
  59. concept input_range = see below;
  60. template<class T>
  61. concept forward_range = see below;
  62. template<class T>
  63. concept bidirectional_range = see below;
  64. template<class T>
  65. concept random_access_range = see below;
  66. template<class T>
  67. concept contiguous_range = see below;
  68. template <class _Tp>
  69. concept common_range = see below;
  70. template<class T>
  71. concept viewable_range = see below;
  72. // [view.interface], class template view_interface
  73. template<class D>
  74. requires is_class_v<D> && same_as<D, remove_cv_t<D>>
  75. class view_interface;
  76. // [range.subrange], sub-ranges
  77. enum class subrange_kind : bool { unsized, sized };
  78. template<input_or_output_iterator I, sentinel_for<I> S = I, subrange_kind K = see below>
  79. requires (K == subrange_kind::sized || !sized_sentinel_for<S, I>)
  80. class subrange;
  81. template<class I, class S, subrange_kind K>
  82. inline constexpr bool enable_borrowed_range<subrange<I, S, K>> = true;
  83. // [range.dangling], dangling iterator handling
  84. struct dangling;
  85. template<range R>
  86. using borrowed_iterator_t = see below;
  87. template<range R>
  88. using borrowed_subrange_t = see below;
  89. // [range.elements], elements view
  90. template<input_range V, size_t N>
  91. requires see below
  92. class elements_view;
  93. template<class T, size_t N>
  94. inline constexpr bool enable_borrowed_range<elements_view<T, N>> =
  95. enable_borrowed_range<T>;
  96. template<class R>
  97. using keys_view = elements_view<R, 0>;
  98. template<class R>
  99. using values_view = elements_view<R, 1>;
  100. namespace views {
  101. template<size_t N>
  102. inline constexpr unspecified elements = unspecified;
  103. inline constexpr auto keys = elements<0>;
  104. inline constexpr auto values = elements<1>;
  105. }
  106. // [range.empty], empty view
  107. template<class T>
  108. requires is_object_v<T>
  109. class empty_view;
  110. template<class T>
  111. inline constexpr bool enable_borrowed_range<empty_view<T>> = true;
  112. namespace views {
  113. template<class T>
  114. inline constexpr empty_view<T> empty{};
  115. }
  116. // [range.all], all view
  117. namespace views {
  118. inline constexpr unspecified all = unspecified;
  119. template<viewable_range R>
  120. using all_t = decltype(all(declval<R>()));
  121. }
  122. template<range R>
  123. requires is_object_v<R>
  124. class ref_view;
  125. template<class T>
  126. inline constexpr bool enable_borrowed_range<ref_view<T>> = true;
  127. template<range R>
  128. requires see below
  129. class owning_view;
  130. template<class T>
  131. inline constexpr bool enable_borrowed_range<owning_view<T>> = enable_borrowed_range<T>;
  132. // [range.filter], filter view
  133. template<input_range V, indirect_unary_predicate<iterator_t<V>> Pred>
  134. requires view<V> && is_object_v<Pred>
  135. class filter_view;
  136. namespace views {
  137. inline constexpr unspecified filter = unspecified;
  138. }
  139. // [range.drop], drop view
  140. template<view V>
  141. class drop_view;
  142. template<class T>
  143. inline constexpr bool enable_borrowed_range<drop_view<T>> = enable_borrowed_range<T>;
  144. // [range.drop.while], drop while view
  145. template<view V, class Pred>
  146. requires input_range<V> && is_object_v<Pred> &&
  147. indirect_unary_predicate<const Pred, iterator_t<V>>
  148. class drop_while_view;
  149. template<class T, class Pred>
  150. inline constexpr bool enable_borrowed_range<drop_while_view<T, Pred>> =
  151. enable_borrowed_range<T>;
  152. namespace views { inline constexpr unspecified drop_while = unspecified; }
  153. // [range.transform], transform view
  154. template<input_range V, copy_constructible F>
  155. requires view<V> && is_object_v<F> &&
  156. regular_invocable<F&, range_reference_t<V>> &&
  157. can-reference<invoke_result_t<F&, range_reference_t<V>>>
  158. class transform_view;
  159. // [range.counted], counted view
  160. namespace views { inline constexpr unspecified counted = unspecified; }
  161. // [range.common], common view
  162. template<view V>
  163. requires (!common_range<V> && copyable<iterator_t<V>>)
  164. class common_view;
  165. // [range.reverse], reverse view
  166. template<view V>
  167. requires bidirectional_range<V>
  168. class reverse_view;
  169. template<class T>
  170. inline constexpr bool enable_borrowed_range<reverse_view<T>> = enable_borrowed_range<T>;
  171. template<class T>
  172. inline constexpr bool enable_borrowed_range<common_view<T>> = enable_borrowed_range<T>;
  173. // [range.take], take view
  174. template<view> class take_view;
  175. template<class T>
  176. inline constexpr bool enable_borrowed_range<take_view<T>> = enable_borrowed_range<T>;
  177. // [range.take.while], take while view
  178. template<view V, class Pred>
  179. requires input_range<V> && is_object_v<Pred> &&
  180. indirect_unary_predicate<const Pred, iterator_t<V>>
  181. class take_while_view;
  182. namespace views { inline constexpr unspecified take_while = unspecified; }
  183. template<copy_constructible T>
  184. requires is_object_v<T>
  185. class single_view;
  186. template<weakly_incrementable W, semiregular Bound = unreachable_sentinel_t>
  187. requires weakly-equality-comparable-with<W, Bound> && copyable<W>
  188. class iota_view;
  189. template<class W, class Bound>
  190. inline constexpr bool enable_borrowed_range<iota_view<W, Bound>> = true;
  191. // [range.join], join view
  192. template<input_range V>
  193. requires view<V> && input_range<range_reference_t<V>>
  194. class join_view;
  195. // [range.lazy.split], lazy split view
  196. template<class R>
  197. concept tiny-range = see below; // exposition only
  198. template<input_range V, forward_range Pattern>
  199. requires view<V> && view<Pattern> &&
  200. indirectly_comparable<iterator_t<V>, iterator_t<Pattern>, ranges::equal_to> &&
  201. (forward_range<V> || tiny-range<Pattern>)
  202. class lazy_split_view;
  203. // [range.split], split view
  204. template<forward_range V, forward_range Pattern>
  205. requires view<V> && view<Pattern> &&
  206. indirectly_comparable<iterator_t<V>, iterator_t<Pattern>, ranges::equal_to>
  207. class split_view;
  208. namespace views {
  209. inline constexpr unspecified lazy_split = unspecified;
  210. inline constexpr unspecified split = unspecified;
  211. }
  212. // [range.istream], istream view
  213. template<movable Val, class CharT, class Traits = char_traits<CharT>>
  214. requires see below
  215. class basic_istream_view;
  216. template<class Val>
  217. using istream_view = basic_istream_view<Val, char>;
  218. template<class Val>
  219. using wistream_view = basic_istream_view<Val, wchar_t>;
  220. namespace views { template<class T> inline constexpr unspecified istream = unspecified; }
  221. // [range.zip], zip view
  222. template<input_range... Views>
  223. requires (view<Views> && ...) && (sizeof...(Views) > 0)
  224. class zip_view; // C++2b
  225. template<class... Views>
  226. inline constexpr bool enable_borrowed_range<zip_view<Views...>> = // C++2b
  227. (enable_borrowed_range<Views> && ...);
  228. namespace views { inline constexpr unspecified zip = unspecified; } // C++2b
  229. // [range.as.rvalue]
  230. template <view V>
  231. requires input_range<V>
  232. class as_rvalue_view; // since C++23
  233. namespace views { inline constexpr unspecified as_rvalue ) unspecified; } // since C++23
  234. }
  235. namespace std {
  236. namespace views = ranges::views;
  237. template<class T> struct tuple_size;
  238. template<size_t I, class T> struct tuple_element;
  239. template<class I, class S, ranges::subrange_kind K>
  240. struct tuple_size<ranges::subrange<I, S, K>>
  241. : integral_constant<size_t, 2> {};
  242. template<class I, class S, ranges::subrange_kind K>
  243. struct tuple_element<0, ranges::subrange<I, S, K>> {
  244. using type = I;
  245. };
  246. template<class I, class S, ranges::subrange_kind K>
  247. struct tuple_element<1, ranges::subrange<I, S, K>> {
  248. using type = S;
  249. };
  250. template<class I, class S, ranges::subrange_kind K>
  251. struct tuple_element<0, const ranges::subrange<I, S, K>> {
  252. using type = I;
  253. };
  254. template<class I, class S, ranges::subrange_kind K>
  255. struct tuple_element<1, const ranges::subrange<I, S, K>> {
  256. using type = S;
  257. };
  258. }
  259. */
  260. #include <__assert> // all public C++ headers provide the assertion handler
  261. #include <__config>
  262. #include <__ranges/access.h>
  263. #include <__ranges/all.h>
  264. #include <__ranges/as_rvalue_view.h>
  265. #include <__ranges/common_view.h>
  266. #include <__ranges/concepts.h>
  267. #include <__ranges/counted.h>
  268. #include <__ranges/dangling.h>
  269. #include <__ranges/data.h>
  270. #include <__ranges/drop_view.h>
  271. #include <__ranges/drop_while_view.h>
  272. #include <__ranges/elements_view.h>
  273. #include <__ranges/empty.h>
  274. #include <__ranges/empty_view.h>
  275. #include <__ranges/enable_borrowed_range.h>
  276. #include <__ranges/enable_view.h>
  277. #include <__ranges/filter_view.h>
  278. #include <__ranges/iota_view.h>
  279. #include <__ranges/join_view.h>
  280. #include <__ranges/lazy_split_view.h>
  281. #include <__ranges/rbegin.h>
  282. #include <__ranges/ref_view.h>
  283. #include <__ranges/rend.h>
  284. #include <__ranges/reverse_view.h>
  285. #include <__ranges/single_view.h>
  286. #include <__ranges/size.h>
  287. #include <__ranges/split_view.h>
  288. #include <__ranges/subrange.h>
  289. #include <__ranges/take_view.h>
  290. #include <__ranges/take_while_view.h>
  291. #include <__ranges/transform_view.h>
  292. #include <__ranges/view_interface.h>
  293. #include <__ranges/views.h>
  294. #include <__ranges/zip_view.h>
  295. #include <type_traits>
  296. #include <version>
  297. #if !defined(_LIBCPP_HAS_NO_LOCALIZATION)
  298. #include <__ranges/istream_view.h>
  299. #endif
  300. // standard-mandated includes
  301. // [ranges.syn]
  302. #include <compare>
  303. #include <initializer_list>
  304. #include <iterator>
  305. // [tuple.helper]
  306. #include <__tuple_dir/tuple_element.h>
  307. #include <__tuple_dir/tuple_size.h>
  308. #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
  309. # pragma GCC system_header
  310. #endif
  311. #endif // _LIBCPP_RANGES