xref: /freebsd/contrib/llvm-project/libcxx/include/ranges (revision 81ad626541db97eb356e2c1d4a20eb2a26a766ab)
1fe6060f1SDimitry Andric// -*- C++ -*-
2349cc55cSDimitry Andric//===----------------------------------------------------------------------===//
3fe6060f1SDimitry Andric//
4fe6060f1SDimitry Andric// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
5fe6060f1SDimitry Andric// See https://llvm.org/LICENSE.txt for license information.
6fe6060f1SDimitry Andric// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7fe6060f1SDimitry Andric//
8fe6060f1SDimitry Andric//===----------------------------------------------------------------------===//
9fe6060f1SDimitry Andric
10fe6060f1SDimitry Andric#ifndef _LIBCPP_RANGES
11fe6060f1SDimitry Andric#define _LIBCPP_RANGES
12fe6060f1SDimitry Andric
13fe6060f1SDimitry Andric/*
14fe6060f1SDimitry Andric
15fe6060f1SDimitry Andric#include <compare>              // see [compare.syn]
16fe6060f1SDimitry Andric#include <initializer_list>     // see [initializer.list.syn]
17fe6060f1SDimitry Andric#include <iterator>             // see [iterator.synopsis]
18fe6060f1SDimitry Andric
19fe6060f1SDimitry Andricnamespace std::ranges {
20fe6060f1SDimitry Andric  inline namespace unspecified {
21fe6060f1SDimitry Andric    // [range.access], range access
22fe6060f1SDimitry Andric    inline constexpr unspecified begin = unspecified;
23fe6060f1SDimitry Andric    inline constexpr unspecified end = unspecified;
24fe6060f1SDimitry Andric    inline constexpr unspecified cbegin = unspecified;
25fe6060f1SDimitry Andric    inline constexpr unspecified cend = unspecified;
26fe6060f1SDimitry Andric
27fe6060f1SDimitry Andric    inline constexpr unspecified size = unspecified;
28fe6060f1SDimitry Andric    inline constexpr unspecified ssize = unspecified;
29fe6060f1SDimitry Andric  }
30fe6060f1SDimitry Andric
31fe6060f1SDimitry Andric  // [range.range], ranges
32fe6060f1SDimitry Andric  template<class T>
33fe6060f1SDimitry Andric    concept range = see below;
34fe6060f1SDimitry Andric
35fe6060f1SDimitry Andric  template<class T>
36fe6060f1SDimitry Andric    inline constexpr bool enable_borrowed_range = false;
37fe6060f1SDimitry Andric
38fe6060f1SDimitry Andric  template<class T>
394824e7fdSDimitry Andric    using iterator_t = decltype(ranges::begin(declval<T&>()));
40fe6060f1SDimitry Andric  template<range R>
41fe6060f1SDimitry Andric    using sentinel_t = decltype(ranges::end(declval<R&>()));
42fe6060f1SDimitry Andric  template<range R>
43fe6060f1SDimitry Andric    using range_difference_t = iter_difference_t<iterator_t<R>>;
44fe6060f1SDimitry Andric  template<sized_range R>
45fe6060f1SDimitry Andric    using range_size_t = decltype(ranges::size(declval<R&>()));
46fe6060f1SDimitry Andric  template<range R>
47fe6060f1SDimitry Andric    using range_value_t = iter_value_t<iterator_t<R>>;
48fe6060f1SDimitry Andric  template<range R>
49fe6060f1SDimitry Andric    using range_reference_t = iter_reference_t<iterator_t<R>>;
50fe6060f1SDimitry Andric  template<range R>
51fe6060f1SDimitry Andric    using range_rvalue_reference_t = iter_rvalue_reference_t<iterator_t<R>>;
52fe6060f1SDimitry Andric
53fe6060f1SDimitry Andric  // [range.sized], sized ranges
54fe6060f1SDimitry Andric  template<class>
55fe6060f1SDimitry Andric    inline constexpr bool disable_sized_range = false;
56fe6060f1SDimitry Andric
57fe6060f1SDimitry Andric  template<class T>
58fe6060f1SDimitry Andric    concept sized_range = ...;
59fe6060f1SDimitry Andric
60fe6060f1SDimitry Andric  // [range.view], views
61fe6060f1SDimitry Andric  template<class T>
62fe6060f1SDimitry Andric    inline constexpr bool enable_view = ...;
63fe6060f1SDimitry Andric
64fe6060f1SDimitry Andric  struct view_base { };
65fe6060f1SDimitry Andric
66fe6060f1SDimitry Andric  template<class T>
67fe6060f1SDimitry Andric    concept view = ...;
68fe6060f1SDimitry Andric
69fe6060f1SDimitry Andric  // [range.refinements], other range refinements
70fe6060f1SDimitry Andric  template<class R, class T>
71fe6060f1SDimitry Andric    concept output_range = see below;
72fe6060f1SDimitry Andric
73fe6060f1SDimitry Andric  template<class T>
74fe6060f1SDimitry Andric    concept input_range = see below;
75fe6060f1SDimitry Andric
76fe6060f1SDimitry Andric  template<class T>
77fe6060f1SDimitry Andric    concept forward_range = see below;
78fe6060f1SDimitry Andric
79fe6060f1SDimitry Andric  template<class T>
80fe6060f1SDimitry Andric  concept bidirectional_range = see below;
81fe6060f1SDimitry Andric
82fe6060f1SDimitry Andric  template<class T>
83fe6060f1SDimitry Andric  concept random_access_range = see below;
84fe6060f1SDimitry Andric
85fe6060f1SDimitry Andric  template<class T>
86fe6060f1SDimitry Andric  concept contiguous_range = see below;
87fe6060f1SDimitry Andric
88fe6060f1SDimitry Andric  template <class _Tp>
89fe6060f1SDimitry Andric    concept common_range = see below;
90fe6060f1SDimitry Andric
91fe6060f1SDimitry Andric  template<class T>
92fe6060f1SDimitry Andric  concept viewable_range = see below;
93fe6060f1SDimitry Andric
94fe6060f1SDimitry Andric  // [view.interface], class template view_interface
95fe6060f1SDimitry Andric  template<class D>
96fe6060f1SDimitry Andric    requires is_class_v<D> && same_as<D, remove_cv_t<D>>
97fe6060f1SDimitry Andric  class view_interface;
98fe6060f1SDimitry Andric
99fe6060f1SDimitry Andric  // [range.subrange], sub-ranges
100fe6060f1SDimitry Andric  enum class subrange_kind : bool { unsized, sized };
101fe6060f1SDimitry Andric
102fe6060f1SDimitry Andric  template<input_or_output_iterator I, sentinel_for<I> S = I, subrange_kind K = see below>
103fe6060f1SDimitry Andric    requires (K == subrange_kind::sized || !sized_sentinel_for<S, I>)
104fe6060f1SDimitry Andric  class subrange;
105fe6060f1SDimitry Andric
106fe6060f1SDimitry Andric  template<class I, class S, subrange_kind K>
107fe6060f1SDimitry Andric    inline constexpr bool enable_borrowed_range<subrange<I, S, K>> = true;
108fe6060f1SDimitry Andric
109fe6060f1SDimitry Andric  // [range.dangling], dangling iterator handling
110fe6060f1SDimitry Andric  struct dangling;
111fe6060f1SDimitry Andric
112fe6060f1SDimitry Andric  template<range R>
113fe6060f1SDimitry Andric    using borrowed_iterator_t = see below;
114fe6060f1SDimitry Andric
115fe6060f1SDimitry Andric  template<range R>
116fe6060f1SDimitry Andric    using borrowed_subrange_t = see below;
117fe6060f1SDimitry Andric
118fe6060f1SDimitry Andric  // [range.empty], empty view
119fe6060f1SDimitry Andric  template<class T>
120fe6060f1SDimitry Andric    requires is_object_v<T>
121fe6060f1SDimitry Andric  class empty_view;
122fe6060f1SDimitry Andric
123*81ad6265SDimitry Andric  template<class T>
124*81ad6265SDimitry Andric    inline constexpr bool enable_borrowed_range<empty_view<T>> = true;
125*81ad6265SDimitry Andric
126*81ad6265SDimitry Andric  namespace views {
127*81ad6265SDimitry Andric    template<class T>
128*81ad6265SDimitry Andric      inline constexpr empty_view<T> empty{};
129*81ad6265SDimitry Andric  }
130*81ad6265SDimitry Andric
131fe6060f1SDimitry Andric  // [range.all], all view
132fe6060f1SDimitry Andric  namespace views {
133fe6060f1SDimitry Andric    inline constexpr unspecified all = unspecified;
134fe6060f1SDimitry Andric
135fe6060f1SDimitry Andric    template<viewable_range R>
136fe6060f1SDimitry Andric      using all_t = decltype(all(declval<R>()));
137fe6060f1SDimitry Andric  }
138fe6060f1SDimitry Andric
139fe6060f1SDimitry Andric  template<range R>
140fe6060f1SDimitry Andric    requires is_object_v<R>
141fe6060f1SDimitry Andric  class ref_view;
142fe6060f1SDimitry Andric
143fe6060f1SDimitry Andric  template<class T>
144fe6060f1SDimitry Andric    inline constexpr bool enable_borrowed_range<ref_view<T>> = true;
145fe6060f1SDimitry Andric
14604eeddc0SDimitry Andric  template<range R>
14704eeddc0SDimitry Andric    requires see below
14804eeddc0SDimitry Andric  class owning_view;
14904eeddc0SDimitry Andric
15004eeddc0SDimitry Andric  template<class T>
15104eeddc0SDimitry Andric    inline constexpr bool enable_borrowed_range<owning_view<T>> = enable_borrowed_range<T>;
15204eeddc0SDimitry Andric
153*81ad6265SDimitry Andric  // [range.filter], filter view
154*81ad6265SDimitry Andric  template<input_range V, indirect_unary_predicate<iterator_t<V>> Pred>
155*81ad6265SDimitry Andric    requires view<V> && is_object_v<Pred>
156*81ad6265SDimitry Andric  class filter_view;
157*81ad6265SDimitry Andric
158*81ad6265SDimitry Andric  namespace views {
159*81ad6265SDimitry Andric    inline constexpr unspecified filter = unspecified;
160*81ad6265SDimitry Andric  }
161*81ad6265SDimitry Andric
162fe6060f1SDimitry Andric  // [range.drop], drop view
163fe6060f1SDimitry Andric  template<view V>
164fe6060f1SDimitry Andric    class drop_view;
165fe6060f1SDimitry Andric
166fe6060f1SDimitry Andric  template<class T>
167fe6060f1SDimitry Andric    inline constexpr bool enable_borrowed_range<drop_view<T>> = enable_borrowed_range<T>;
168fe6060f1SDimitry Andric
169fe6060f1SDimitry Andric  // [range.transform], transform view
170fe6060f1SDimitry Andric  template<input_range V, copy_constructible F>
171fe6060f1SDimitry Andric    requires view<V> && is_object_v<F> &&
172fe6060f1SDimitry Andric             regular_invocable<F&, range_reference_t<V>> &&
173fe6060f1SDimitry Andric             can-reference<invoke_result_t<F&, range_reference_t<V>>>
174fe6060f1SDimitry Andric  class transform_view;
175fe6060f1SDimitry Andric
176349cc55cSDimitry Andric  // [range.counted], counted view
177349cc55cSDimitry Andric  namespace views { inline constexpr unspecified counted = unspecified; }
178349cc55cSDimitry Andric
179fe6060f1SDimitry Andric  // [range.common], common view
180fe6060f1SDimitry Andric  template<view V>
181fe6060f1SDimitry Andric    requires (!common_range<V> && copyable<iterator_t<V>>)
182fe6060f1SDimitry Andric  class common_view;
183fe6060f1SDimitry Andric
184349cc55cSDimitry Andric // [range.reverse], reverse view
185349cc55cSDimitry Andric  template<view V>
186349cc55cSDimitry Andric    requires bidirectional_range<V>
187349cc55cSDimitry Andric  class reverse_view;
188349cc55cSDimitry Andric
189349cc55cSDimitry Andric  template<class T>
190349cc55cSDimitry Andric    inline constexpr bool enable_borrowed_range<reverse_view<T>> = enable_borrowed_range<T>;
191349cc55cSDimitry Andric
192fe6060f1SDimitry Andric  template<class T>
193fe6060f1SDimitry Andric  inline constexpr bool enable_borrowed_range<common_view<T>> = enable_borrowed_range<T>;
194349cc55cSDimitry Andric
195349cc55cSDimitry Andric   // [range.take], take view
196349cc55cSDimitry Andric  template<view> class take_view;
197349cc55cSDimitry Andric
198349cc55cSDimitry Andric  template<class T>
199349cc55cSDimitry Andric  inline constexpr bool enable_borrowed_range<take_view<T>> = enable_borrowed_range<T>;
200349cc55cSDimitry Andric
201349cc55cSDimitry Andric  template<copy_constructible T>
202349cc55cSDimitry Andric    requires is_object_v<T>
203349cc55cSDimitry Andric  class single_view;
204349cc55cSDimitry Andric
205349cc55cSDimitry Andric  template<weakly_incrementable W, semiregular Bound = unreachable_sentinel_t>
206349cc55cSDimitry Andric    requires weakly-equality-comparable-with<W, Bound> && copyable<W>
207349cc55cSDimitry Andric  class iota_view;
208349cc55cSDimitry Andric
209349cc55cSDimitry Andric  template<class W, class Bound>
210349cc55cSDimitry Andric    inline constexpr bool enable_borrowed_range<iota_view<W, Bound>> = true;
211349cc55cSDimitry Andric
212349cc55cSDimitry Andric  // [range.join], join view
213349cc55cSDimitry Andric  template<input_range V>
214349cc55cSDimitry Andric    requires view<V> && input_range<range_reference_t<V>>
215349cc55cSDimitry Andric  class join_view;
216*81ad6265SDimitry Andric
217*81ad6265SDimitry Andric  // [range.lazy.split], lazy split view
218*81ad6265SDimitry Andric  template<class R>
219*81ad6265SDimitry Andric    concept tiny-range = see below;   // exposition only
220*81ad6265SDimitry Andric
221*81ad6265SDimitry Andric  template<input_range V, forward_range Pattern>
222*81ad6265SDimitry Andric    requires view<V> && view<Pattern> &&
223*81ad6265SDimitry Andric             indirectly_comparable<iterator_t<V>, iterator_t<Pattern>, ranges::equal_to> &&
224*81ad6265SDimitry Andric             (forward_range<V> || tiny-range<Pattern>)
225*81ad6265SDimitry Andric  class lazy_split_view;
226*81ad6265SDimitry Andric
227*81ad6265SDimitry Andric  namespace views {
228*81ad6265SDimitry Andric    inline constexpr unspecified lazy_split = unspecified;
229fe6060f1SDimitry Andric  }
230fe6060f1SDimitry Andric
231*81ad6265SDimitry Andric  // [range.zip], zip view
232*81ad6265SDimitry Andric  template<input_range... Views>
233*81ad6265SDimitry Andric    requires (view<Views> && ...) && (sizeof...(Views) > 0)
234*81ad6265SDimitry Andric  class zip_view;        // C++2b
235*81ad6265SDimitry Andric
236*81ad6265SDimitry Andric  template<class... Views>
237*81ad6265SDimitry Andric    inline constexpr bool enable_borrowed_range<zip_view<Views...>> =    // C++2b
238*81ad6265SDimitry Andric      (enable_borrowed_range<Views> && ...);
239*81ad6265SDimitry Andric
240*81ad6265SDimitry Andric  namespace views { inline constexpr unspecified zip = unspecified; }    // C++2b
241*81ad6265SDimitry Andric}
242*81ad6265SDimitry Andric
243*81ad6265SDimitry Andricnamespace std {
244*81ad6265SDimitry Andric  namespace views = ranges::views;
245*81ad6265SDimitry Andric
246*81ad6265SDimitry Andric  template<class T> struct tuple_size;
247*81ad6265SDimitry Andric  template<size_t I, class T> struct tuple_element;
248*81ad6265SDimitry Andric
249*81ad6265SDimitry Andric  template<class I, class S, ranges::subrange_kind K>
250*81ad6265SDimitry Andric  struct tuple_size<ranges::subrange<I, S, K>>
251*81ad6265SDimitry Andric    : integral_constant<size_t, 2> {};
252*81ad6265SDimitry Andric
253*81ad6265SDimitry Andric  template<class I, class S, ranges::subrange_kind K>
254*81ad6265SDimitry Andric  struct tuple_element<0, ranges::subrange<I, S, K>> {
255*81ad6265SDimitry Andric    using type = I;
256*81ad6265SDimitry Andric  };
257*81ad6265SDimitry Andric
258*81ad6265SDimitry Andric  template<class I, class S, ranges::subrange_kind K>
259*81ad6265SDimitry Andric  struct tuple_element<1, ranges::subrange<I, S, K>> {
260*81ad6265SDimitry Andric    using type = S;
261*81ad6265SDimitry Andric  };
262*81ad6265SDimitry Andric
263*81ad6265SDimitry Andric  template<class I, class S, ranges::subrange_kind K>
264*81ad6265SDimitry Andric  struct tuple_element<0, const ranges::subrange<I, S, K>> {
265*81ad6265SDimitry Andric    using type = I;
266*81ad6265SDimitry Andric  };
267*81ad6265SDimitry Andric
268*81ad6265SDimitry Andric  template<class I, class S, ranges::subrange_kind K>
269*81ad6265SDimitry Andric  struct tuple_element<1, const ranges::subrange<I, S, K>> {
270*81ad6265SDimitry Andric    using type = S;
271*81ad6265SDimitry Andric  };
272*81ad6265SDimitry Andric}
273fe6060f1SDimitry Andric*/
274fe6060f1SDimitry Andric
275*81ad6265SDimitry Andric#include <__assert> // all public C++ headers provide the assertion handler
276fe6060f1SDimitry Andric#include <__config>
277fe6060f1SDimitry Andric#include <__ranges/access.h>
278fe6060f1SDimitry Andric#include <__ranges/all.h>
279fe6060f1SDimitry Andric#include <__ranges/common_view.h>
280fe6060f1SDimitry Andric#include <__ranges/concepts.h>
281349cc55cSDimitry Andric#include <__ranges/counted.h>
282fe6060f1SDimitry Andric#include <__ranges/dangling.h>
283fe6060f1SDimitry Andric#include <__ranges/data.h>
284fe6060f1SDimitry Andric#include <__ranges/drop_view.h>
285349cc55cSDimitry Andric#include <__ranges/empty.h>
28604eeddc0SDimitry Andric#include <__ranges/empty_view.h>
287fe6060f1SDimitry Andric#include <__ranges/enable_borrowed_range.h>
288fe6060f1SDimitry Andric#include <__ranges/enable_view.h>
289*81ad6265SDimitry Andric#include <__ranges/filter_view.h>
290349cc55cSDimitry Andric#include <__ranges/iota_view.h>
291349cc55cSDimitry Andric#include <__ranges/join_view.h>
292*81ad6265SDimitry Andric#include <__ranges/lazy_split_view.h>
293*81ad6265SDimitry Andric#include <__ranges/rbegin.h>
294fe6060f1SDimitry Andric#include <__ranges/ref_view.h>
295*81ad6265SDimitry Andric#include <__ranges/rend.h>
296349cc55cSDimitry Andric#include <__ranges/reverse_view.h>
297349cc55cSDimitry Andric#include <__ranges/single_view.h>
298fe6060f1SDimitry Andric#include <__ranges/size.h>
299fe6060f1SDimitry Andric#include <__ranges/subrange.h>
300349cc55cSDimitry Andric#include <__ranges/take_view.h>
301fe6060f1SDimitry Andric#include <__ranges/transform_view.h>
302fe6060f1SDimitry Andric#include <__ranges/view_interface.h>
30353683b95SDimitry Andric#include <__ranges/views.h>
304*81ad6265SDimitry Andric#include <__ranges/zip_view.h>
305*81ad6265SDimitry Andric#include <__tuple> // TODO: <ranges> has to export std::tuple_size. Replace this, once <tuple> is granularized.
306fe6060f1SDimitry Andric#include <compare>          // Required by the standard.
307fe6060f1SDimitry Andric#include <initializer_list> // Required by the standard.
308fe6060f1SDimitry Andric#include <iterator>         // Required by the standard.
309fe6060f1SDimitry Andric#include <type_traits>
310d56accc7SDimitry Andric#include <version>
311fe6060f1SDimitry Andric
312fe6060f1SDimitry Andric#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
313fe6060f1SDimitry Andric#  pragma GCC system_header
314fe6060f1SDimitry Andric#endif
315fe6060f1SDimitry Andric
316fe6060f1SDimitry Andric#endif // _LIBCPP_RANGES
317