blob: 0154dbc39c08a2d1ee320870bc6c6db449101b48 [file] [log] [blame]
Howard Hinnantc51e1022010-05-11 19:42:16 +00001// -*- C++ -*-
Louis Dionne9bd93882021-11-17 16:25:01 -05002//===----------------------------------------------------------------------===//
Howard Hinnantc51e1022010-05-11 19:42:16 +00003//
Chandler Carruthd2012102019-01-19 10:56:40 +00004// 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
Howard Hinnantc51e1022010-05-11 19:42:16 +00007//
8//===----------------------------------------------------------------------===//
9
10#ifndef _LIBCPP_ALGORITHM
11#define _LIBCPP_ALGORITHM
12
13/*
14 algorithm synopsis
15
16#include <initializer_list>
17
18namespace std
19{
20
Nikolas Klauserf74be4e2022-01-14 02:55:51 +010021namespace ranges {
Konstantin Varlamov89a23f32022-06-28 11:59:59 -070022
23 // [algorithms.results], algorithm result types
Nikolas Klauser671b4752022-02-11 17:01:58 +010024 template <class I, class F>
Nikolas Klauser2e263162022-02-21 22:48:36 +010025 struct in_fun_result; // since C++20
Nikolas Klauser671b4752022-02-11 17:01:58 +010026
Nikolas Klauserf74be4e2022-01-14 02:55:51 +010027 template <class I1, class I2>
Nikolas Klauser2e263162022-02-21 22:48:36 +010028 struct in_in_result; // since C++20
Nikolas Klauser05e2cd82022-01-25 11:21:47 +010029
Konstantin Varlamov89a23f32022-06-28 11:59:59 -070030 template <class I, class O>
31 struct in_out_result; // since C++20
32
Nikolas Klauser05e2cd82022-01-25 11:21:47 +010033 template <class I1, class I2, class O>
Nikolas Klauser2e263162022-02-21 22:48:36 +010034 struct in_in_out_result; // since C++20
Nikolas Klauser61ce8162022-02-03 02:17:03 +010035
36 template <class I, class O1, class O2>
37 struct in_out_out_result; // since C++20
Nikolas Klauser671b4752022-02-11 17:01:58 +010038
Nikolas Klauser2e263162022-02-21 22:48:36 +010039 template <class I1, class I2>
40 struct min_max_result; // since C++20
41
Nikolas Klauserdd5ad212022-02-21 23:07:02 +010042 template <class I>
43 struct in_found_result; // since C++20
44
Nikolas Klauser0a62a172022-02-11 13:11:57 +010045 template<forward_iterator I, sentinel_for<I> S, class Proj = identity,
46 indirect_strict_weak_order<projected<I, Proj>> Comp = ranges::less> // since C++20
47 constexpr I min_element(I first, S last, Comp comp = {}, Proj proj = {});
48
49 template<forward_range R, class Proj = identity,
50 indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less> // since C++20
51 constexpr borrowed_iterator_t<R> min_element(R&& r, Comp comp = {}, Proj proj = {});
Nikolas Klauser12fc9bf2022-03-08 23:12:35 +010052
Nikolas Klauser10c612d2022-05-22 13:43:37 +020053 template<forward_iterator I, sentinel_for<I> S, class Proj = identity,
54 indirect_strict_weak_order<projected<I, Proj>> Comp = ranges::less>
55 constexpr I ranges::max_element(I first, S last, Comp comp = {}, Proj proj = {}); // since C++20
56
57 template<forward_range R, class Proj = identity,
58 indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less>
59 constexpr borrowed_iterator_t<R> ranges::max_element(R&& r, Comp comp = {}, Proj proj = {}); // since C++20
60
Konstantin Varlamov89a23f32022-06-28 11:59:59 -070061 template<class I1, class I2>
62 using mismatch_result = in_in_result<I1, I2>;
63
Nikolas Klauser12fc9bf2022-03-08 23:12:35 +010064 template <input_iterator I1, sentinel_for<_I1> S1, input_iterator I2, sentinel_for<_I2> S2,
65 class Pred = ranges::equal_to, class Proj1 = identity, class Proj2 = identity>
66 requires indirectly_comparable<I1, I2, Pred, Proj1, Proj2>
67 constexpr mismatch_result<_I1, _I2>
68 mismatch()(I1 first1, S1 last1, I2 first2, S2 last2, Pred pred = {}, Proj1 proj1 = {}, Proj2 proj2 = {}) // since C++20
69
70 template <input_range R1, input_range R2,
71 class Pred = ranges::equal_to, class Proj1 = identity, class Proj2 = identity>
72 requires indirectly_comparable<iterator_t<R1>, iterator_t<R2>, Pred, Proj1, Proj2>
73 constexpr mismatch_result<borrowed_iterator_t<R1>, borrowed_iterator_t<R2>>
74 mismatch(R1&& r1, R2&& r2, Pred pred = {}, Proj1 proj1 = {}, Proj2 proj2 = {}) // since C++20
Nikolas Klauser37d076e2022-03-12 01:45:35 +010075
Nikolas Klauser37d076e2022-03-12 01:45:35 +010076 requires indirect_binary_predicate<ranges::equal_to, projected<I, Proj>, const T*>
77 constexpr I find(I first, S last, const T& value, Proj proj = {}); // since C++20
78
79 template<input_range R, class T, class Proj = identity>
80 requires indirect_binary_predicate<ranges::equal_to, projected<iterator_t<R>, Proj>, const T*>
81 constexpr borrowed_iterator_t<R>
82 find(R&& r, const T& value, Proj proj = {}); // since C++20
83
84 template<input_iterator I, sentinel_for<I> S, class Proj = identity,
85 indirect_unary_predicate<projected<I, Proj>> Pred>
86 constexpr I find_if(I first, S last, Pred pred, Proj proj = {}); // since C++20
87
88 template<input_range R, class Proj = identity,
89 indirect_unary_predicate<projected<iterator_t<R>, Proj>> Pred>
90 constexpr borrowed_iterator_t<R>
91 find_if(R&& r, Pred pred, Proj proj = {}); // since C++20
92
93 template<input_iterator I, sentinel_for<I> S, class Proj = identity,
94 indirect_unary_predicate<projected<I, Proj>> Pred>
95 constexpr I find_if_not(I first, S last, Pred pred, Proj proj = {}); // since C++20
96
97 template<input_range R, class Proj = identity,
98 indirect_unary_predicate<projected<iterator_t<R>, Proj>> Pred>
99 constexpr borrowed_iterator_t<R>
100 find_if_not(R&& r, Pred pred, Proj proj = {}); // since C++20
Nikolas Klauser3559e452022-03-18 02:57:08 +0100101
Nikolas Klauser573cd6f2022-04-03 09:17:01 +0200102 template<class T, class Proj = identity,
103 indirect_strict_weak_order<projected<const T*, Proj>> Comp = ranges::less>
104 constexpr const T& min(const T& a, const T& b, Comp comp = {}, Proj proj = {}); // since C++20
Nikolas Klauser3559e452022-03-18 02:57:08 +0100105
Nikolas Klauser573cd6f2022-04-03 09:17:01 +0200106 template<copyable T, class Proj = identity,
107 indirect_strict_weak_order<projected<const T*, Proj>> Comp = ranges::less>
108 constexpr T min(initializer_list<T> r, Comp comp = {}, Proj proj = {}); // since C++20
Nikolas Klauser3559e452022-03-18 02:57:08 +0100109
110 template<input_range R, class Proj = identity,
111 indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less>
112 requires indirectly_copyable_storable<iterator_t<R>, range_value_t<R>*>
113 constexpr range_value_t<R>
114 min(R&& r, Comp comp = {}, Proj proj = {}); // since C++20
Nikolas Klauser573cd6f2022-04-03 09:17:01 +0200115
116 template<class T, class Proj = identity,
117 indirect_strict_weak_order<projected<const T*, Proj>> Comp = ranges::less>
118 constexpr const T& max(const T& a, const T& b, Comp comp = {}, Proj proj = {}); // since C++20
119
120 template<copyable T, class Proj = identity,
121 indirect_strict_weak_order<projected<const T*, Proj>> Comp = ranges::less>
122 constexpr T max(initializer_list<T> r, Comp comp = {}, Proj proj = {}); // since C++20
123
124 template<input_range R, class Proj = identity,
125 indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less>
126 requires indirectly_copyable_storable<iterator_t<R>, range_value_t<R>*>
127 constexpr range_value_t<R>
128 max(R&& r, Comp comp = {}, Proj proj = {}); // since C++20
Nikolas Klauser559a1772022-04-05 11:05:36 +0200129
130 template<class I, class O>
131 using unary_transform_result = in_out_result<I, O>; // since C++20
132
133 template<class I1, class I2, class O>
134 using binary_transform_result = in_in_out_result<I1, I2, O>; // since C++20
135
136 template<input_iterator I, sentinel_for<I> S, weakly_incrementable O,
137 copy_constructible F, class Proj = identity>
138 requires indirectly_writable<O, indirect_result_t<F&, projected<I, Proj>>>
139 constexpr ranges::unary_transform_result<I, O>
140 transform(I first1, S last1, O result, F op, Proj proj = {}); // since C++20
141
142 template<input_range R, weakly_incrementable O, copy_constructible F,
143 class Proj = identity>
144 requires indirectly_writable<O, indirect_result_t<F&, projected<iterator_t<R>, Proj>>>
145 constexpr ranges::unary_transform_result<borrowed_iterator_t<R>, O>
146 transform(R&& r, O result, F op, Proj proj = {}); // since C++20
147
148 template<input_iterator I1, sentinel_for<I1> S1, input_iterator I2, sentinel_for<I2> S2,
149 weakly_incrementable O, copy_constructible F, class Proj1 = identity,
150 class Proj2 = identity>
151 requires indirectly_writable<O, indirect_result_t<F&, projected<I1, Proj1>,
152 projected<I2, Proj2>>>
153 constexpr ranges::binary_transform_result<I1, I2, O>
154 transform(I1 first1, S1 last1, I2 first2, S2 last2, O result,
155 F binary_op, Proj1 proj1 = {}, Proj2 proj2 = {}); // since C++20
156
157 template<input_range R1, input_range R2, weakly_incrementable O,
158 copy_constructible F, class Proj1 = identity, class Proj2 = identity>
159 requires indirectly_writable<O, indirect_result_t<F&, projected<iterator_t<R1>, Proj1>,
160 projected<iterator_t<R2>, Proj2>>>
161 constexpr ranges::binary_transform_result<borrowed_iterator_t<R1>, borrowed_iterator_t<R2>, O>
162 transform(R1&& r1, R2&& r2, O result,
163 F binary_op, Proj1 proj1 = {}, Proj2 proj2 = {}); // since C++20
Nikolas Klauserf1373d02022-04-07 13:02:02 +0200164
165 template<input_iterator I, sentinel_for<I> S, class T, class Proj = identity>
166 requires indirect_binary_predicate<ranges::equal_to, projected<I, Proj>, const T*>
167 constexpr iter_difference_t<I>
168 count(I first, S last, const T& value, Proj proj = {}); // since C++20
169
170 template<input_range R, class T, class Proj = identity>
171 requires indirect_binary_predicate<ranges::equal_to, projected<iterator_t<R>, Proj>, const T*>
172 constexpr range_difference_t<R>
173 count(R&& r, const T& value, Proj proj = {}); // since C++20
174
175 template<input_iterator I, sentinel_for<I> S, class Proj = identity,
176 indirect_unary_predicate<projected<I, Proj>> Pred>
177 constexpr iter_difference_t<I>
178 count_if(I first, S last, Pred pred, Proj proj = {}); // since C++20
179
180 template<input_range R, class Proj = identity,
181 indirect_unary_predicate<projected<iterator_t<R>, Proj>> Pred>
182 constexpr range_difference_t<R>
183 count_if(R&& r, Pred pred, Proj proj = {}); // since C++20
Nikolas Klauser0a2f44f2022-04-13 22:59:09 +0200184
Konstantin Varlamov89a23f32022-06-28 11:59:59 -0700185 template<class T>
186 using minmax_result = min_max_result<T>;
187
Nikolas Klauser0a2f44f2022-04-13 22:59:09 +0200188 template<class T, class Proj = identity,
189 indirect_strict_weak_order<projected<const T*, Proj>> Comp = ranges::less>
190 constexpr ranges::minmax_result<const T&>
191 minmax(const T& a, const T& b, Comp comp = {}, Proj proj = {}); // since C++20
192
193 template<copyable T, class Proj = identity,
194 indirect_strict_weak_order<projected<const T*, Proj>> Comp = ranges::less>
195 constexpr ranges::minmax_result<T>
196 minmax(initializer_list<T> r, Comp comp = {}, Proj proj = {}); // since C++20
197
198 template<input_range R, class Proj = identity,
199 indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less>
200 requires indirectly_copyable_storable<iterator_t<R>, range_value_t<R>*>
201 constexpr ranges::minmax_result<range_value_t<R>>
202 minmax(R&& r, Comp comp = {}, Proj proj = {}); // since C++20
203
Konstantin Varlamov89a23f32022-06-28 11:59:59 -0700204 template<class I>
205 using minmax_element_result = min_max_result<I>;
206
Nikolas Klauser0a2f44f2022-04-13 22:59:09 +0200207 template<forward_iterator I, sentinel_for<I> S, class Proj = identity,
208 indirect_strict_weak_order<projected<I, Proj>> Comp = ranges::less>
209 constexpr ranges::minmax_element_result<I>
210 minmax_element(I first, S last, Comp comp = {}, Proj proj = {}); // since C++20
211
212 template<forward_range R, class Proj = identity,
213 indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less>
214 constexpr ranges::minmax_element_result<borrowed_iterator_t<R>>
215 minmax_element(R&& r, Comp comp = {}, Proj proj = {}); // since C++20
Nikolas Klauserd959d842022-04-15 13:43:40 +0200216
217 template<class I, class O>
Konstantin Varlamov89a23f32022-06-28 11:59:59 -0700218 using copy_result = in_out_result<I, O>; // since C++20
Nikolas Klauserd959d842022-04-15 13:43:40 +0200219
Konstantin Varlamov89a23f32022-06-28 11:59:59 -0700220 template<class I, class O>
221 using copy_n_result = in_out_result<I, O>; // since C++20
Nikolas Klauserd959d842022-04-15 13:43:40 +0200222
223 template<class I, class O>
224 using copy_if_result = in_out_result<I, O>; // since C++20
225
226 template<class I1, class I2>
227 using copy_backward_result = in_out_result<I1, I2>; // since C++20
228
229 template<input_iterator I, sentinel_for<I> S, weakly_incrementable O>
230 requires indirectly_copyable<I, O>
231 constexpr ranges::copy_result<I, O> ranges::copy(I first, S last, O result); // since C++20
232
233 template<input_range R, weakly_incrementable O>
234 requires indirectly_copyable<iterator_t<R>, O>
235 constexpr ranges::copy_result<borrowed_iterator_t<R>, O> ranges::copy(R&& r, O result); // since C++20
236
237 template<input_iterator I, weakly_incrementable O>
238 requires indirectly_copyable<I, O>
239 constexpr ranges::copy_n_result<I, O>
240 ranges::copy_n(I first, iter_difference_t<I> n, O result); // since C++20
241
242 template<input_iterator I, sentinel_for<I> S, weakly_incrementable O, class Proj = identity,
243 indirect_unary_predicate<projected<I, Proj>> Pred>
244 requires indirectly_copyable<I, O>
245 constexpr ranges::copy_if_result<I, O>
246 ranges::copy_if(I first, S last, O result, Pred pred, Proj proj = {}); // since C++20
247
248 template<input_range R, weakly_incrementable O, class Proj = identity,
249 indirect_unary_predicate<projected<iterator_t<R>, Proj>> Pred>
250 requires indirectly_copyable<iterator_t<R>, O>
251 constexpr ranges::copy_if_result<borrowed_iterator_t<R>, O>
252 ranges::copy_if(R&& r, O result, Pred pred, Proj proj = {}); // since C++20
253
254 template<bidirectional_iterator I1, sentinel_for<I1> S1, bidirectional_iterator I2>
255 requires indirectly_copyable<I1, I2>
256 constexpr ranges::copy_backward_result<I1, I2>
257 ranges::copy_backward(I1 first, S1 last, I2 result); // since C++20
258
259 template<bidirectional_range R, bidirectional_iterator I>
260 requires indirectly_copyable<iterator_t<R>, I>
261 constexpr ranges::copy_backward_result<borrowed_iterator_t<R>, I>
262 ranges::copy_backward(R&& r, I result); // since C++20
Nikolas Klauser58de98c2022-05-04 20:27:07 +0200263
264 template<class I, class F>
265 using for_each_result = in_fun_result<I, F>; // since C++20
266
267 template<input_iterator I, sentinel_for<I> S, class Proj = identity,
268 indirectly_unary_invocable<projected<I, Proj>> Fun>
269 constexpr ranges::for_each_result<I, Fun>
270 ranges::for_each(I first, S last, Fun f, Proj proj = {}); // since C++20
271
272 template<input_range R, class Proj = identity,
273 indirectly_unary_invocable<projected<iterator_t<R>, Proj>> Fun>
274 constexpr ranges::for_each_result<borrowed_iterator_t<R>, Fun>
275 ranges::for_each(R&& r, Fun f, Proj proj = {}); // since C++20
276
277 template<input_iterator I, class Proj = identity,
278 indirectly_unary_invocable<projected<I, Proj>> Fun>
279 constexpr ranges::for_each_n_result<I, Fun>
280 ranges::for_each_n(I first, iter_difference_t<I> n, Fun f, Proj proj = {}); // since C++20
Nikolas Klauserbb9049d2022-05-04 14:19:09 +0200281
282 template<input_iterator I, sentinel_for<I> S, class Proj = identity,
283 indirect_unary_predicate<projected<I, Proj>> Pred>
284 constexpr bool ranges::is_partitioned(I first, S last, Pred pred, Proj proj = {}); // since C++20
285
286 template<input_range R, class Proj = identity,
287 indirect_unary_predicate<projected<iterator_t<R>, Proj>> Pred>
288 constexpr bool ranges::is_partitioned(R&& r, Pred pred, Proj proj = {}); // since C++20
289
Nikolas Klauser52f20072022-05-24 10:32:50 +0200290 template<bidirectional_iterator I, sentinel_for<I> S>
291 requires permutable<I>
292 constexpr I ranges::reverse(I first, S last); // since C++20
293
294 template<bidirectional_range R>
295 requires permutable<iterator_t<R>>
296 constexpr borrowed_iterator_t<R> ranges::reverse(R&& r); // since C++20
297
Konstantin Varlamov55e39a82022-06-16 15:20:53 -0700298 template<random_access_iterator I, sentinel_for<I> S, class Comp = ranges::less,
299 class Proj = identity>
300 requires sortable<I, Comp, Proj>
301 constexpr I
Konstantin Varlamovdc3e7822022-07-01 16:34:08 -0700302 ranges::sort(I first, S last, Comp comp = {}, Proj proj = {}); // since C++20
Konstantin Varlamov55e39a82022-06-16 15:20:53 -0700303
304 template<random_access_range R, class Comp = ranges::less, class Proj = identity>
305 requires sortable<iterator_t<R>, Comp, Proj>
306 constexpr borrowed_iterator_t<R>
Konstantin Varlamovdc3e7822022-07-01 16:34:08 -0700307 ranges::sort(R&& r, Comp comp = {}, Proj proj = {}); // since C++20
308
309 template<random_access_iterator I, sentinel_for<I> S, class Comp = ranges::less,
310 class Proj = identity>
311 requires sortable<I, Comp, Proj>
312 I ranges::stable_sort(I first, S last, Comp comp = {}, Proj proj = {}); // since C++20
313
314 template<random_access_range R, class Comp = ranges::less, class Proj = identity>
315 requires sortable<iterator_t<R>, Comp, Proj>
316 borrowed_iterator_t<R>
317 ranges::stable_sort(R&& r, Comp comp = {}, Proj proj = {}); // since C++20
Konstantin Varlamov55e39a82022-06-16 15:20:53 -0700318
Nikolas Klausereb49c2a2022-05-21 18:26:29 +0200319 template<class T, output_iterator<const T&> O, sentinel_for<O> S>
320 constexpr O ranges::fill(O first, S last, const T& value); // since C++20
321
322 template<class T, output_range<const T&> R>
323 constexpr borrowed_iterator_t<R> ranges::fill(R&& r, const T& value); // since C++20
324
325 template<class T, output_iterator<const T&> O>
326 constexpr O ranges::fill_n(O first, iter_difference_t<O> n, const T& value); // since C++20
Nikolas Klauser353f1dd2022-05-25 11:09:43 +0200327
328 template<input_iterator I1, sentinel_for<I1> S1, input_iterator I2, sentinel_for<I2> S2,
329 class Pred = ranges::equal_to, class Proj1 = identity, class Proj2 = identity>
330 requires indirectly_comparable<I1, I2, Pred, Proj1, Proj2>
331 constexpr bool ranges::equal(I1 first1, S1 last1, I2 first2, S2 last2,
332 Pred pred = {},
333 Proj1 proj1 = {}, Proj2 proj2 = {}); // since C++20
334
335 template<input_range R1, input_range R2, class Pred = ranges::equal_to,
336 class Proj1 = identity, class Proj2 = identity>
337 requires indirectly_comparable<iterator_t<R1>, iterator_t<R2>, Pred, Proj1, Proj2>
338 constexpr bool ranges::equal(R1&& r1, R2&& r2, Pred pred = {},
339 Proj1 proj1 = {}, Proj2 proj2 = {}); // since C++20
340
Nikolas Klausered3f0e82022-05-26 16:42:46 +0200341 template<input_iterator I, sentinel_for<I> S, class Proj = identity,
342 indirect_unary_predicate<projected<I, Proj>> Pred>
343 constexpr bool ranges::all_of(I first, S last, Pred pred, Proj proj = {}); // since C++20
344
345 template<input_range R, class Proj = identity,
346 indirect_unary_predicate<projected<iterator_t<R>, Proj>> Pred>
347 constexpr bool ranges::all_of(R&& r, Pred pred, Proj proj = {}); // since C++20
348
349 template<input_iterator I, sentinel_for<I> S, class Proj = identity,
350 indirect_unary_predicate<projected<I, Proj>> Pred>
351 constexpr bool ranges::any_of(I first, S last, Pred pred, Proj proj = {}); // since C++20
352
353 template<input_range R, class Proj = identity,
354 indirect_unary_predicate<projected<iterator_t<R>, Proj>> Pred>
355 constexpr bool ranges::any_of(R&& r, Pred pred, Proj proj = {}); // since C++20
356
357 template<input_iterator I, sentinel_for<I> S, class Proj = identity,
358 indirect_unary_predicate<projected<I, Proj>> Pred>
359 constexpr bool ranges::none_of(I first, S last, Pred pred, Proj proj = {}); // since C++20
360
361 template<input_range R, class Proj = identity,
362 indirect_unary_predicate<projected<iterator_t<R>, Proj>> Pred>
363 constexpr bool ranges::none_of(R&& r, Pred pred, Proj proj = {}); // since C++20
364
Nikolas Klauserab0b7af2022-05-26 16:08:55 +0200365 template<forward_iterator I, sentinel_for<I> S, class Proj = identity,
366 indirect_strict_weak_order<projected<I, Proj>> Comp = ranges::less>
367 constexpr bool ranges::is_sorted(I first, S last, Comp comp = {}, Proj proj = {}); // since C++20
368
369 template<forward_range R, class Proj = identity,
370 indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less>
371 constexpr bool ranges::is_sorted(R&& r, Comp comp = {}, Proj proj = {}); // since C++20
372
373 template<forward_iterator I, sentinel_for<I> S, class Proj = identity,
374 indirect_strict_weak_order<projected<I, Proj>> Comp = ranges::less>
375 constexpr I ranges::is_sorted_until(I first, S last, Comp comp = {}, Proj proj = {}); // since C++20
376
377 template<forward_range R, class Proj = identity,
378 indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less>
379 constexpr borrowed_iterator_t<R>
380 ranges::is_sorted_until(R&& r, Comp comp = {}, Proj proj = {}); // since C++20
Nikolas Klauser8b381972022-06-05 21:15:16 +0200381
382 template<forward_iterator I, sentinel_for<I> S, class T, class Proj = identity,
383 indirect_strict_weak_order<const T*, projected<I, Proj>> Comp = ranges::less>
384 constexpr I upper_bound(I first, S last, const T& value, Comp comp = {}, Proj proj = {}); // since C++20
385
386 template<forward_range R, class T, class Proj = identity,
387 indirect_strict_weak_order<const T*, projected<iterator_t<R>, Proj>> Comp =
388 ranges::less>
389 constexpr borrowed_iterator_t<R>
390 upper_bound(R&& r, const T& value, Comp comp = {}, Proj proj = {}); // since C++20
391
392 template<forward_iterator I, sentinel_for<I> S, class T, class Proj = identity,
393 indirect_strict_weak_order<const T*, projected<I, Proj>> Comp = ranges::less>
394 constexpr I lower_bound(I first, S last, const T& value, Comp comp = {},
395 Proj proj = {}); // since C++20
396 template<forward_range R, class T, class Proj = identity,
397 indirect_strict_weak_order<const T*, projected<iterator_t<R>, Proj>> Comp =
398 ranges::less>
399 constexpr borrowed_iterator_t<R>
400 lower_bound(R&& r, const T& value, Comp comp = {}, Proj proj = {}); // since C++20
401
402 template<forward_iterator I, sentinel_for<I> S, class T, class Proj = identity,
403 indirect_strict_weak_order<const T*, projected<I, Proj>> Comp = ranges::less>
404 constexpr bool binary_search(I first, S last, const T& value, Comp comp = {},
405 Proj proj = {}); // since C++20
Nikolas Klauser0a7e46d2022-06-06 13:57:34 +0200406
Nikolas Klauser8b381972022-06-05 21:15:16 +0200407 template<forward_range R, class T, class Proj = identity,
408 indirect_strict_weak_order<const T*, projected<iterator_t<R>, Proj>> Comp =
409 ranges::less>
410 constexpr bool binary_search(R&& r, const T& value, Comp comp = {},
411 Proj proj = {}); // since C++20
Nikolas Klauser0a7e46d2022-06-06 13:57:34 +0200412 template<input_iterator I1, sentinel_for<I1> S1, forward_iterator I2, sentinel_for<I2> S2,
413 class Pred = ranges::equal_to, class Proj1 = identity, class Proj2 = identity>
414 requires indirectly_comparable<I1, I2, Pred, Proj1, Proj2>
415 constexpr I1 ranges::find_first_of(I1 first1, S1 last1, I2 first2, S2 last2,
416 Pred pred = {},
417 Proj1 proj1 = {}, Proj2 proj2 = {}); // since C++20
418
419 template<input_range R1, forward_range R2,
420 class Pred = ranges::equal_to, class Proj1 = identity, class Proj2 = identity>
421 requires indirectly_comparable<iterator_t<R1>, iterator_t<R2>, Pred, Proj1, Proj2>
422 constexpr borrowed_iterator_t<R1>
423 ranges::find_first_of(R1&& r1, R2&& r2,
424 Pred pred = {},
425 Proj1 proj1 = {}, Proj2 proj2 = {}); // since C++20
Nikolas Klauser8b381972022-06-05 21:15:16 +0200426
Nikolas Klauser5ae708f2022-06-08 12:14:12 +0200427 template<forward_iterator I, sentinel_for<I> S, class Proj = identity,
428 indirect_binary_predicate<projected<I, Proj>,
429 projected<I, Proj>> Pred = ranges::equal_to>
430 constexpr I ranges::adjacent_find(I first, S last, Pred pred = {}, Proj proj = {}); // since C+20
431
432 template<forward_range R, class Proj = identity,
433 indirect_binary_predicate<projected<iterator_t<R>, Proj>,
434 projected<iterator_t<R>, Proj>> Pred = ranges::equal_to>
435 constexpr borrowed_iterator_t<R> ranges::adjacent_find(R&& r, Pred pred = {}, Proj proj = {}); // since C++20
436
Nikolas Klauserfadea392022-06-07 09:42:10 +0200437 template<input_iterator I, sentinel_for<I> S, class T1, class T2, class Proj = identity>
438 requires indirectly_writable<I, const T2&> &&
439 indirect_binary_predicate<ranges::equal_to, projected<I, Proj>, const T1*>
440 constexpr I
441 ranges::replace(I first, S last, const T1& old_value, const T2& new_value, Proj proj = {}); // since C++20
442
443 template<input_range R, class T1, class T2, class Proj = identity>
444 requires indirectly_writable<iterator_t<R>, const T2&> &&
445 indirect_binary_predicate<ranges::equal_to, projected<iterator_t<R>, Proj>, const T1*>
446 constexpr borrowed_iterator_t<R>
447 ranges::replace(R&& r, const T1& old_value, const T2& new_value, Proj proj = {}); // since C++20
448
449 template<input_iterator I, sentinel_for<I> S, class T, class Proj = identity,
450 indirect_unary_predicate<projected<I, Proj>> Pred>
451 requires indirectly_writable<I, const T&>
452 constexpr I ranges::replace_if(I first, S last, Pred pred, const T& new_value, Proj proj = {}); // since C++20
453
454 template<input_range R, class T, class Proj = identity,
455 indirect_unary_predicate<projected<iterator_t<R>, Proj>> Pred>
456 requires indirectly_writable<iterator_t<R>, const T&>
457 constexpr borrowed_iterator_t<R>
458 ranges::replace_if(R&& r, Pred pred, const T& new_value, Proj proj = {}); // since C++20
459
Nikolas Klauser2fd677c2022-06-15 16:24:43 +0200460 template<input_iterator I1, sentinel_for<I1> S1, input_iterator I2, sentinel_for<I2> S2,
461 class Proj1 = identity, class Proj2 = identity,
462 indirect_strict_weak_order<projected<I1, Proj1>,
463 projected<I2, Proj2>> Comp = ranges::less>
464 constexpr bool
465 ranges::lexicographical_compare(I1 first1, S1 last1, I2 first2, S2 last2,
466 Comp comp = {}, Proj1 proj1 = {}, Proj2 proj2 = {}); // since C++20
467
468 template<input_range R1, input_range R2, class Proj1 = identity,
469 class Proj2 = identity,
470 indirect_strict_weak_order<projected<iterator_t<R1>, Proj1>,
471 projected<iterator_t<R2>, Proj2>> Comp = ranges::less>
472 constexpr bool
473 ranges::lexicographical_compare(R1&& r1, R2&& r2, Comp comp = {},
474 Proj1 proj1 = {}, Proj2 proj2 = {}); // since C++20
475
Nikolas Klauser16661d82022-06-23 12:23:41 +0200476 template<bidirectional_iterator I1, sentinel_for<I1> S1, bidirectional_iterator I2>
477 requires indirectly_movable<I1, I2>
478 constexpr ranges::move_backward_result<I1, I2>
479 ranges::move_backward(I1 first, S1 last, I2 result); // since C++20
480
481 template<bidirectional_range R, bidirectional_iterator I>
482 requires indirectly_movable<iterator_t<R>, I>
483 constexpr ranges::move_backward_result<borrowed_iterator_t<R>, I>
484 ranges::move_backward(R&& r, I result); // since C++20
485
486 template<input_iterator I, sentinel_for<I> S, weakly_incrementable O>
487 requires indirectly_movable<I, O>
488 constexpr ranges::move_result<I, O>
489 ranges::move(I first, S last, O result); // since C++20
490
491 template<input_range R, weakly_incrementable O>
492 requires indirectly_movable<iterator_t<R>, O>
493 constexpr ranges::move_result<borrowed_iterator_t<R>, O>
494 ranges::move(R&& r, O result); // since C++20
495
496
Nikolas Klauserf74be4e2022-01-14 02:55:51 +0100497}
498
Marshall Clowd607fdb2018-01-15 17:20:36 +0000499 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000500 all_of(InputIterator first, InputIterator last, Predicate pred);
501
502template <class InputIterator, class Predicate>
Marshall Clowd607fdb2018-01-15 17:20:36 +0000503 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000504 any_of(InputIterator first, InputIterator last, Predicate pred);
505
506template <class InputIterator, class Predicate>
Marshall Clowd607fdb2018-01-15 17:20:36 +0000507 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000508 none_of(InputIterator first, InputIterator last, Predicate pred);
509
510template <class InputIterator, class Function>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000511 constexpr Function // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000512 for_each(InputIterator first, InputIterator last, Function f);
513
Marshall Clowde0169c2017-05-25 02:29:54 +0000514template<class InputIterator, class Size, class Function>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000515 constexpr InputIterator // constexpr in C++20
516 for_each_n(InputIterator first, Size n, Function f); // C++17
Marshall Clowde0169c2017-05-25 02:29:54 +0000517
Howard Hinnantc51e1022010-05-11 19:42:16 +0000518template <class InputIterator, class T>
Marshall Clowee0161e2018-01-15 19:26:05 +0000519 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000520 find(InputIterator first, InputIterator last, const T& value);
521
522template <class InputIterator, class Predicate>
Marshall Clowee0161e2018-01-15 19:26:05 +0000523 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000524 find_if(InputIterator first, InputIterator last, Predicate pred);
525
526template<class InputIterator, class Predicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500527 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000528 find_if_not(InputIterator first, InputIterator last, Predicate pred);
529
530template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500531 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000532 find_end(ForwardIterator1 first1, ForwardIterator1 last1,
533 ForwardIterator2 first2, ForwardIterator2 last2);
534
535template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500536 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000537 find_end(ForwardIterator1 first1, ForwardIterator1 last1,
538 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
539
540template <class ForwardIterator1, class ForwardIterator2>
Marshall Clowee0161e2018-01-15 19:26:05 +0000541 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000542 find_first_of(ForwardIterator1 first1, ForwardIterator1 last1,
543 ForwardIterator2 first2, ForwardIterator2 last2);
544
545template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clowee0161e2018-01-15 19:26:05 +0000546 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000547 find_first_of(ForwardIterator1 first1, ForwardIterator1 last1,
548 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
549
550template <class ForwardIterator>
Marshall Clowee0161e2018-01-15 19:26:05 +0000551 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000552 adjacent_find(ForwardIterator first, ForwardIterator last);
553
554template <class ForwardIterator, class BinaryPredicate>
Marshall Clowee0161e2018-01-15 19:26:05 +0000555 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000556 adjacent_find(ForwardIterator first, ForwardIterator last, BinaryPredicate pred);
557
558template <class InputIterator, class T>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000559 constexpr typename iterator_traits<InputIterator>::difference_type // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000560 count(InputIterator first, InputIterator last, const T& value);
561
562template <class InputIterator, class Predicate>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000563 constexpr typename iterator_traits<InputIterator>::difference_type // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000564 count_if(InputIterator first, InputIterator last, Predicate pred);
565
566template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000567 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000568 mismatch(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2);
569
Marshall Clow96b42b22013-05-09 21:14:23 +0000570template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000571 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Aditya Kumar3a0179a2016-08-25 11:52:38 +0000572 mismatch(InputIterator1 first1, InputIterator1 last1,
Marshall Clow96b42b22013-05-09 21:14:23 +0000573 InputIterator2 first2, InputIterator2 last2); // **C++14**
574
Howard Hinnantc51e1022010-05-11 19:42:16 +0000575template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000576 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000577 mismatch(InputIterator1 first1, InputIterator1 last1,
578 InputIterator2 first2, BinaryPredicate pred);
579
Marshall Clow96b42b22013-05-09 21:14:23 +0000580template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000581 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000582 mismatch(InputIterator1 first1, InputIterator1 last1,
583 InputIterator2 first2, InputIterator2 last2,
584 BinaryPredicate pred); // **C++14**
585
Howard Hinnantc51e1022010-05-11 19:42:16 +0000586template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000587 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000588 equal(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2);
589
Marshall Clow96b42b22013-05-09 21:14:23 +0000590template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000591 constexpr bool // constexpr in C++20
Aditya Kumar3a0179a2016-08-25 11:52:38 +0000592 equal(InputIterator1 first1, InputIterator1 last1,
Marshall Clow96b42b22013-05-09 21:14:23 +0000593 InputIterator2 first2, InputIterator2 last2); // **C++14**
594
Howard Hinnantc51e1022010-05-11 19:42:16 +0000595template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000596 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000597 equal(InputIterator1 first1, InputIterator1 last1,
598 InputIterator2 first2, BinaryPredicate pred);
599
Marshall Clow96b42b22013-05-09 21:14:23 +0000600template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000601 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000602 equal(InputIterator1 first1, InputIterator1 last1,
603 InputIterator2 first2, InputIterator2 last2,
604 BinaryPredicate pred); // **C++14**
605
Howard Hinnantc51e1022010-05-11 19:42:16 +0000606template<class ForwardIterator1, class ForwardIterator2>
Marshall Clow96d050a2018-01-15 16:16:32 +0000607 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000608 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
609 ForwardIterator2 first2);
610
Marshall Clow96b42b22013-05-09 21:14:23 +0000611template<class ForwardIterator1, class ForwardIterator2>
Marshall Clow96d050a2018-01-15 16:16:32 +0000612 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000613 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
614 ForwardIterator2 first2, ForwardIterator2 last2); // **C++14**
615
Howard Hinnantc51e1022010-05-11 19:42:16 +0000616template<class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000617 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000618 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
619 ForwardIterator2 first2, BinaryPredicate pred);
620
Marshall Clow96b42b22013-05-09 21:14:23 +0000621template<class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000622 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000623 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
624 ForwardIterator2 first2, ForwardIterator2 last2,
625 BinaryPredicate pred); // **C++14**
626
Howard Hinnantc51e1022010-05-11 19:42:16 +0000627template <class ForwardIterator1, class ForwardIterator2>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000628 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000629 search(ForwardIterator1 first1, ForwardIterator1 last1,
630 ForwardIterator2 first2, ForwardIterator2 last2);
631
632template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000633 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000634 search(ForwardIterator1 first1, ForwardIterator1 last1,
635 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
636
637template <class ForwardIterator, class Size, class T>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000638 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000639 search_n(ForwardIterator first, ForwardIterator last, Size count, const T& value);
640
641template <class ForwardIterator, class Size, class T, class BinaryPredicate>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000642 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000643 search_n(ForwardIterator first, ForwardIterator last,
644 Size count, const T& value, BinaryPredicate pred);
645
646template <class InputIterator, class OutputIterator>
Louis Dionne65b433b2019-11-06 12:02:41 +0000647 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000648 copy(InputIterator first, InputIterator last, OutputIterator result);
649
650template<class InputIterator, class OutputIterator, class Predicate>
Louis Dionne65b433b2019-11-06 12:02:41 +0000651 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000652 copy_if(InputIterator first, InputIterator last,
653 OutputIterator result, Predicate pred);
654
655template<class InputIterator, class Size, class OutputIterator>
Louis Dionne65b433b2019-11-06 12:02:41 +0000656 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000657 copy_n(InputIterator first, Size n, OutputIterator result);
658
659template <class BidirectionalIterator1, class BidirectionalIterator2>
Louis Dionne65b433b2019-11-06 12:02:41 +0000660 constexpr BidirectionalIterator2 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000661 copy_backward(BidirectionalIterator1 first, BidirectionalIterator1 last,
662 BidirectionalIterator2 result);
663
Konstantin Varlamov89a23f32022-06-28 11:59:59 -0700664// [alg.move], move
665template<class InputIterator, class OutputIterator>
666 constexpr OutputIterator move(InputIterator first, InputIterator last,
667 OutputIterator result);
668
669template<class BidirectionalIterator1, class BidirectionalIterator2>
670 constexpr BidirectionalIterator2
671 move_backward(BidirectionalIterator1 first, BidirectionalIterator1 last,
672 BidirectionalIterator2 result);
673
Howard Hinnantc51e1022010-05-11 19:42:16 +0000674template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500675 constexpr ForwardIterator2 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000676 swap_ranges(ForwardIterator1 first1, ForwardIterator1 last1, ForwardIterator2 first2);
677
Konstantin Varlamov89a23f32022-06-28 11:59:59 -0700678namespace ranges {
679 template<class I1, class I2>
680 using swap_ranges_result = in_in_result<I1, I2>;
681
Nikolas Klauser4ceab5f2022-02-10 13:33:03 +0100682template<input_iterator I1, sentinel_for<I1> S1, input_iterator I2, sentinel_for<I2> S2>
683 requires indirectly_swappable<I1, I2>
684 constexpr ranges::swap_ranges_result<I1, I2>
Konstantin Varlamov89a23f32022-06-28 11:59:59 -0700685 swap_ranges(I1 first1, S1 last1, I2 first2, S2 last2);
Nikolas Klauser4ceab5f2022-02-10 13:33:03 +0100686
687template<input_range R1, input_range R2>
688 requires indirectly_swappable<iterator_t<R1>, iterator_t<R2>>
689 constexpr ranges::swap_ranges_result<borrowed_iterator_t<R1>, borrowed_iterator_t<R2>>
Konstantin Varlamov89a23f32022-06-28 11:59:59 -0700690 swap_ranges(R1&& r1, R2&& r2);
691}
Nikolas Klauser4ceab5f2022-02-10 13:33:03 +0100692
Howard Hinnantc51e1022010-05-11 19:42:16 +0000693template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500694 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000695 iter_swap(ForwardIterator1 a, ForwardIterator2 b);
696
697template <class InputIterator, class OutputIterator, class UnaryOperation>
Marshall Clow31427c62018-01-19 17:45:39 +0000698 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000699 transform(InputIterator first, InputIterator last, OutputIterator result, UnaryOperation op);
700
701template <class InputIterator1, class InputIterator2, class OutputIterator, class BinaryOperation>
Marshall Clow31427c62018-01-19 17:45:39 +0000702 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000703 transform(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2,
704 OutputIterator result, BinaryOperation binary_op);
705
706template <class ForwardIterator, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000707 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000708 replace(ForwardIterator first, ForwardIterator last, const T& old_value, const T& new_value);
709
710template <class ForwardIterator, class Predicate, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000711 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000712 replace_if(ForwardIterator first, ForwardIterator last, Predicate pred, const T& new_value);
713
714template <class InputIterator, class OutputIterator, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000715 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000716 replace_copy(InputIterator first, InputIterator last, OutputIterator result,
717 const T& old_value, const T& new_value);
718
719template <class InputIterator, class OutputIterator, class Predicate, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000720 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000721 replace_copy_if(InputIterator first, InputIterator last, OutputIterator result, Predicate pred, const T& new_value);
722
723template <class ForwardIterator, class T>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000724 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000725 fill(ForwardIterator first, ForwardIterator last, const T& value);
726
727template <class OutputIterator, class Size, class T>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000728 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000729 fill_n(OutputIterator first, Size n, const T& value);
730
731template <class ForwardIterator, class Generator>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000732 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000733 generate(ForwardIterator first, ForwardIterator last, Generator gen);
734
735template <class OutputIterator, class Size, class Generator>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000736 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000737 generate_n(OutputIterator first, Size n, Generator gen);
738
739template <class ForwardIterator, class T>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000740 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000741 remove(ForwardIterator first, ForwardIterator last, const T& value);
742
743template <class ForwardIterator, class Predicate>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000744 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000745 remove_if(ForwardIterator first, ForwardIterator last, Predicate pred);
746
747template <class InputIterator, class OutputIterator, class T>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000748 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000749 remove_copy(InputIterator first, InputIterator last, OutputIterator result, const T& value);
750
751template <class InputIterator, class OutputIterator, class Predicate>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000752 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000753 remove_copy_if(InputIterator first, InputIterator last, OutputIterator result, Predicate pred);
754
755template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500756 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000757 unique(ForwardIterator first, ForwardIterator last);
758
759template <class ForwardIterator, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500760 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000761 unique(ForwardIterator first, ForwardIterator last, BinaryPredicate pred);
762
763template <class InputIterator, class OutputIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500764 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000765 unique_copy(InputIterator first, InputIterator last, OutputIterator result);
766
767template <class InputIterator, class OutputIterator, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500768 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000769 unique_copy(InputIterator first, InputIterator last, OutputIterator result, BinaryPredicate pred);
770
771template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500772 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000773 reverse(BidirectionalIterator first, BidirectionalIterator last);
774
775template <class BidirectionalIterator, class OutputIterator>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000776 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000777 reverse_copy(BidirectionalIterator first, BidirectionalIterator last, OutputIterator result);
778
779template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500780 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000781 rotate(ForwardIterator first, ForwardIterator middle, ForwardIterator last);
782
783template <class ForwardIterator, class OutputIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500784 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000785 rotate_copy(ForwardIterator first, ForwardIterator middle, ForwardIterator last, OutputIterator result);
786
787template <class RandomAccessIterator>
788 void
Marshall Clowfac06e52017-03-23 13:43:37 +0000789 random_shuffle(RandomAccessIterator first, RandomAccessIterator last); // deprecated in C++14, removed in C++17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000790
791template <class RandomAccessIterator, class RandomNumberGenerator>
792 void
Marshall Clow83f35392014-03-03 06:14:19 +0000793 random_shuffle(RandomAccessIterator first, RandomAccessIterator last,
Marshall Clowfac06e52017-03-23 13:43:37 +0000794 RandomNumberGenerator& rand); // deprecated in C++14, removed in C++17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000795
Eric Fiselier1208fcd2016-08-28 22:14:37 +0000796template<class PopulationIterator, class SampleIterator,
797 class Distance, class UniformRandomBitGenerator>
798 SampleIterator sample(PopulationIterator first, PopulationIterator last,
799 SampleIterator out, Distance n,
800 UniformRandomBitGenerator&& g); // C++17
801
Howard Hinnant578ac0f2010-05-26 17:49:34 +0000802template<class RandomAccessIterator, class UniformRandomNumberGenerator>
803 void shuffle(RandomAccessIterator first, RandomAccessIterator last,
Howard Hinnanta5e71782010-11-18 01:47:02 +0000804 UniformRandomNumberGenerator&& g);
Howard Hinnant578ac0f2010-05-26 17:49:34 +0000805
Arthur O'Dwyercea050d2020-12-26 01:39:03 -0500806template<class ForwardIterator>
807 constexpr ForwardIterator
808 shift_left(ForwardIterator first, ForwardIterator last,
809 typename iterator_traits<ForwardIterator>::difference_type n); // C++20
810
811template<class ForwardIterator>
812 constexpr ForwardIterator
813 shift_right(ForwardIterator first, ForwardIterator last,
814 typename iterator_traits<ForwardIterator>::difference_type n); // C++20
815
Howard Hinnantc51e1022010-05-11 19:42:16 +0000816template <class InputIterator, class Predicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000817 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000818 is_partitioned(InputIterator first, InputIterator last, Predicate pred);
819
820template <class ForwardIterator, class Predicate>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500821 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000822 partition(ForwardIterator first, ForwardIterator last, Predicate pred);
823
824template <class InputIterator, class OutputIterator1,
825 class OutputIterator2, class Predicate>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000826 constexpr pair<OutputIterator1, OutputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000827 partition_copy(InputIterator first, InputIterator last,
828 OutputIterator1 out_true, OutputIterator2 out_false,
829 Predicate pred);
830
831template <class ForwardIterator, class Predicate>
832 ForwardIterator
833 stable_partition(ForwardIterator first, ForwardIterator last, Predicate pred);
834
835template<class ForwardIterator, class Predicate>
Marshall Clowe00916c2018-01-16 02:34:41 +0000836 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000837 partition_point(ForwardIterator first, ForwardIterator last, Predicate pred);
838
839template <class ForwardIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +0000840 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000841 is_sorted(ForwardIterator first, ForwardIterator last);
842
843template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500844 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000845 is_sorted(ForwardIterator first, ForwardIterator last, Compare comp);
846
847template<class ForwardIterator>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000848 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000849 is_sorted_until(ForwardIterator first, ForwardIterator last);
850
851template <class ForwardIterator, class Compare>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000852 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000853 is_sorted_until(ForwardIterator first, ForwardIterator last, Compare comp);
854
855template <class RandomAccessIterator>
Arthur O'Dwyer1bb0f672020-12-20 15:21:42 -0500856 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000857 sort(RandomAccessIterator first, RandomAccessIterator last);
858
859template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer1bb0f672020-12-20 15:21:42 -0500860 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000861 sort(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
862
863template <class RandomAccessIterator>
864 void
865 stable_sort(RandomAccessIterator first, RandomAccessIterator last);
866
867template <class RandomAccessIterator, class Compare>
868 void
869 stable_sort(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
870
871template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500872 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000873 partial_sort(RandomAccessIterator first, RandomAccessIterator middle, RandomAccessIterator last);
874
875template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500876 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000877 partial_sort(RandomAccessIterator first, RandomAccessIterator middle, RandomAccessIterator last, Compare comp);
878
879template <class InputIterator, class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500880 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000881 partial_sort_copy(InputIterator first, InputIterator last,
882 RandomAccessIterator result_first, RandomAccessIterator result_last);
883
884template <class InputIterator, class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500885 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000886 partial_sort_copy(InputIterator first, InputIterator last,
887 RandomAccessIterator result_first, RandomAccessIterator result_last, Compare comp);
888
889template <class RandomAccessIterator>
Arthur O'Dwyer4f5717b2021-02-04 18:12:52 -0500890 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000891 nth_element(RandomAccessIterator first, RandomAccessIterator nth, RandomAccessIterator last);
892
893template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer4f5717b2021-02-04 18:12:52 -0500894 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000895 nth_element(RandomAccessIterator first, RandomAccessIterator nth, RandomAccessIterator last, Compare comp);
896
897template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000898 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000899 lower_bound(ForwardIterator first, ForwardIterator last, const T& value);
900
901template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000902 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000903 lower_bound(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
904
905template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000906 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000907 upper_bound(ForwardIterator first, ForwardIterator last, const T& value);
908
909template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000910 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000911 upper_bound(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
912
913template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000914 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000915 equal_range(ForwardIterator first, ForwardIterator last, const T& value);
916
917template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000918 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000919 equal_range(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
920
921template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000922 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000923 binary_search(ForwardIterator first, ForwardIterator last, const T& value);
924
925template <class ForwardIterator, class T, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000926 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000927 binary_search(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
928
929template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500930 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000931 merge(InputIterator1 first1, InputIterator1 last1,
932 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
933
934template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500935 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000936 merge(InputIterator1 first1, InputIterator1 last1,
937 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
938
939template <class BidirectionalIterator>
940 void
941 inplace_merge(BidirectionalIterator first, BidirectionalIterator middle, BidirectionalIterator last);
942
943template <class BidirectionalIterator, class Compare>
944 void
945 inplace_merge(BidirectionalIterator first, BidirectionalIterator middle, BidirectionalIterator last, Compare comp);
946
947template <class InputIterator1, class InputIterator2>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000948 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000949 includes(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2);
950
951template <class InputIterator1, class InputIterator2, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000952 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000953 includes(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2, Compare comp);
954
955template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500956 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000957 set_union(InputIterator1 first1, InputIterator1 last1,
958 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
959
960template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500961 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000962 set_union(InputIterator1 first1, InputIterator1 last1,
963 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
964
965template <class InputIterator1, class InputIterator2, class OutputIterator>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000966 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000967 set_intersection(InputIterator1 first1, InputIterator1 last1,
968 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
969
970template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000971 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000972 set_intersection(InputIterator1 first1, InputIterator1 last1,
973 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
974
975template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500976 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000977 set_difference(InputIterator1 first1, InputIterator1 last1,
978 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
979
980template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500981 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000982 set_difference(InputIterator1 first1, InputIterator1 last1,
983 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
984
985template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500986 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000987 set_symmetric_difference(InputIterator1 first1, InputIterator1 last1,
988 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
989
990template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500991 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000992 set_symmetric_difference(InputIterator1 first1, InputIterator1 last1,
993 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
994
995template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500996 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000997 push_heap(RandomAccessIterator first, RandomAccessIterator last);
998
999template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -05001000 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +00001001 push_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
1002
1003template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -05001004 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +00001005 pop_heap(RandomAccessIterator first, RandomAccessIterator last);
1006
1007template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -05001008 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +00001009 pop_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
1010
1011template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -05001012 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +00001013 make_heap(RandomAccessIterator first, RandomAccessIterator last);
1014
1015template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -05001016 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +00001017 make_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
1018
1019template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -05001020 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +00001021 sort_heap(RandomAccessIterator first, RandomAccessIterator last);
1022
1023template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -05001024 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +00001025 sort_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
1026
Howard Hinnant3b6579a2010-08-22 00:02:43 +00001027template <class RandomAccessIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +00001028 constexpr bool // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +00001029 is_heap(RandomAccessIterator first, RandomAccessiterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001030
Howard Hinnant3b6579a2010-08-22 00:02:43 +00001031template <class RandomAccessIterator, class Compare>
Marshall Clow96d050a2018-01-15 16:16:32 +00001032 constexpr bool // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +00001033 is_heap(RandomAccessIterator first, RandomAccessiterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001034
Howard Hinnant3b6579a2010-08-22 00:02:43 +00001035template <class RandomAccessIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +00001036 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +00001037 is_heap_until(RandomAccessIterator first, RandomAccessiterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001038
Howard Hinnant3b6579a2010-08-22 00:02:43 +00001039template <class RandomAccessIterator, class Compare>
Marshall Clow96d050a2018-01-15 16:16:32 +00001040 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +00001041 is_heap_until(RandomAccessIterator first, RandomAccessiterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001042
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001043template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001044 constexpr ForwardIterator // constexpr in C++14
1045 min_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001046
1047template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001048 constexpr ForwardIterator // constexpr in C++14
1049 min_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001050
Howard Hinnantc51e1022010-05-11 19:42:16 +00001051template <class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001052 constexpr const T& // constexpr in C++14
1053 min(const T& a, const T& b);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001054
1055template <class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001056 constexpr const T& // constexpr in C++14
1057 min(const T& a, const T& b, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001058
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001059template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001060 constexpr T // constexpr in C++14
1061 min(initializer_list<T> t);
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001062
1063template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001064 constexpr T // constexpr in C++14
1065 min(initializer_list<T> t, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001066
Marshall Clow3e18d0e2016-03-07 22:43:49 +00001067template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001068 constexpr const T& clamp(const T& v, const T& lo, const T& hi); // C++17
Marshall Clow3e18d0e2016-03-07 22:43:49 +00001069
1070template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001071 constexpr const T& clamp(const T& v, const T& lo, const T& hi, Compare comp); // C++17
Marshall Clow3e18d0e2016-03-07 22:43:49 +00001072
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001073template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001074 constexpr ForwardIterator // constexpr in C++14
1075 max_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001076
1077template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001078 constexpr ForwardIterator // constexpr in C++14
1079 max_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001080
Howard Hinnantc51e1022010-05-11 19:42:16 +00001081template <class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001082 constexpr const T& // constexpr in C++14
1083 max(const T& a, const T& b);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001084
1085template <class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001086 constexpr const T& // constexpr in C++14
1087 max(const T& a, const T& b, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001088
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001089template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001090 constexpr T // constexpr in C++14
1091 max(initializer_list<T> t);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001092
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001093template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001094 constexpr T // constexpr in C++14
1095 max(initializer_list<T> t, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001096
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001097template<class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001098 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++14
1099 minmax_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001100
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001101template<class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001102 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++14
1103 minmax_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001104
1105template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001106 constexpr pair<const T&, const T&> // constexpr in C++14
1107 minmax(const T& a, const T& b);
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001108
1109template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001110 constexpr pair<const T&, const T&> // constexpr in C++14
1111 minmax(const T& a, const T& b, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001112
1113template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001114 constexpr pair<T, T> // constexpr in C++14
1115 minmax(initializer_list<T> t);
Howard Hinnantb120e7a2010-08-21 20:10:01 +00001116
1117template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -05001118 constexpr pair<T, T> // constexpr in C++14
1119 minmax(initializer_list<T> t, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001120
1121template <class InputIterator1, class InputIterator2>
Marshall Clow5492c8a2018-01-22 20:44:33 +00001122 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +00001123 lexicographical_compare(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2);
1124
1125template <class InputIterator1, class InputIterator2, class Compare>
Marshall Clow5492c8a2018-01-22 20:44:33 +00001126 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +00001127 lexicographical_compare(InputIterator1 first1, InputIterator1 last1,
1128 InputIterator2 first2, InputIterator2 last2, Compare comp);
1129
1130template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -05001131 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +00001132 next_permutation(BidirectionalIterator first, BidirectionalIterator last);
1133
1134template <class BidirectionalIterator, class Compare>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -05001135 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +00001136 next_permutation(BidirectionalIterator first, BidirectionalIterator last, Compare comp);
1137
1138template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -05001139 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +00001140 prev_permutation(BidirectionalIterator first, BidirectionalIterator last);
1141
1142template <class BidirectionalIterator, class Compare>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -05001143 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +00001144 prev_permutation(BidirectionalIterator first, BidirectionalIterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +00001145} // std
1146
1147*/
1148
Louis Dionneb4fce352022-03-25 12:55:36 -04001149#include <__assert> // all public C++ headers provide the assertion handler
Arthur O'Dwyer3693d7a2022-02-04 13:09:30 -05001150#include <__bits>
Howard Hinnantc51e1022010-05-11 19:42:16 +00001151#include <__config>
Louis Dionnea60dd872021-06-17 11:30:11 -04001152#include <__debug>
Howard Hinnant60e5cf42012-07-26 17:09:09 +00001153#include <cstddef>
Arthur O'Dwyeref181602021-05-19 11:57:04 -04001154#include <cstring>
Arthur O'Dwyeref181602021-05-19 11:57:04 -04001155#include <memory>
1156#include <type_traits>
Marshall Clow0a1e7502018-09-12 19:41:40 +00001157#include <version>
Howard Hinnantea382952013-08-14 18:00:20 +00001158
Louis Dionnea60dd872021-06-17 11:30:11 -04001159#include <__algorithm/adjacent_find.h>
1160#include <__algorithm/all_of.h>
1161#include <__algorithm/any_of.h>
1162#include <__algorithm/binary_search.h>
1163#include <__algorithm/clamp.h>
1164#include <__algorithm/comp.h>
1165#include <__algorithm/comp_ref_type.h>
1166#include <__algorithm/copy.h>
1167#include <__algorithm/copy_backward.h>
1168#include <__algorithm/copy_if.h>
1169#include <__algorithm/copy_n.h>
1170#include <__algorithm/count.h>
1171#include <__algorithm/count_if.h>
1172#include <__algorithm/equal.h>
1173#include <__algorithm/equal_range.h>
Louis Dionnea60dd872021-06-17 11:30:11 -04001174#include <__algorithm/fill.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -05001175#include <__algorithm/fill_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -04001176#include <__algorithm/find.h>
1177#include <__algorithm/find_end.h>
1178#include <__algorithm/find_first_of.h>
1179#include <__algorithm/find_if.h>
1180#include <__algorithm/find_if_not.h>
1181#include <__algorithm/for_each.h>
1182#include <__algorithm/for_each_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -04001183#include <__algorithm/generate.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -05001184#include <__algorithm/generate_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -04001185#include <__algorithm/half_positive.h>
Nikolas Klauserdd5ad212022-02-21 23:07:02 +01001186#include <__algorithm/in_found_result.h>
Nikolas Klauser671b4752022-02-11 17:01:58 +01001187#include <__algorithm/in_fun_result.h>
Nikolas Klauser05e2cd82022-01-25 11:21:47 +01001188#include <__algorithm/in_in_out_result.h>
Nikolas Klauserf74be4e2022-01-14 02:55:51 +01001189#include <__algorithm/in_in_result.h>
Nikolas Klauser61ce8162022-02-03 02:17:03 +01001190#include <__algorithm/in_out_out_result.h>
Konstantin Varlamov74736812022-01-10 22:49:37 -08001191#include <__algorithm/in_out_result.h>
Louis Dionnea60dd872021-06-17 11:30:11 -04001192#include <__algorithm/includes.h>
1193#include <__algorithm/inplace_merge.h>
1194#include <__algorithm/is_heap.h>
1195#include <__algorithm/is_heap_until.h>
1196#include <__algorithm/is_partitioned.h>
1197#include <__algorithm/is_permutation.h>
1198#include <__algorithm/is_sorted.h>
1199#include <__algorithm/is_sorted_until.h>
Christopher Di Bella41f26e82021-06-05 02:47:47 +00001200#include <__algorithm/iter_swap.h>
Louis Dionnea60dd872021-06-17 11:30:11 -04001201#include <__algorithm/lexicographical_compare.h>
1202#include <__algorithm/lower_bound.h>
1203#include <__algorithm/make_heap.h>
1204#include <__algorithm/max.h>
1205#include <__algorithm/max_element.h>
1206#include <__algorithm/merge.h>
1207#include <__algorithm/min.h>
1208#include <__algorithm/min_element.h>
Nikolas Klauser2e263162022-02-21 22:48:36 +01001209#include <__algorithm/min_max_result.h>
Louis Dionnea60dd872021-06-17 11:30:11 -04001210#include <__algorithm/minmax.h>
1211#include <__algorithm/minmax_element.h>
1212#include <__algorithm/mismatch.h>
1213#include <__algorithm/move.h>
1214#include <__algorithm/move_backward.h>
1215#include <__algorithm/next_permutation.h>
1216#include <__algorithm/none_of.h>
1217#include <__algorithm/nth_element.h>
1218#include <__algorithm/partial_sort.h>
1219#include <__algorithm/partial_sort_copy.h>
1220#include <__algorithm/partition.h>
1221#include <__algorithm/partition_copy.h>
1222#include <__algorithm/partition_point.h>
1223#include <__algorithm/pop_heap.h>
1224#include <__algorithm/prev_permutation.h>
1225#include <__algorithm/push_heap.h>
Nikolas Klauser5ae708f2022-06-08 12:14:12 +02001226#include <__algorithm/ranges_adjacent_find.h>
Nikolas Klausered3f0e82022-05-26 16:42:46 +02001227#include <__algorithm/ranges_all_of.h>
1228#include <__algorithm/ranges_any_of.h>
Nikolas Klauser8b381972022-06-05 21:15:16 +02001229#include <__algorithm/ranges_binary_search.h>
Nikolas Klauserd959d842022-04-15 13:43:40 +02001230#include <__algorithm/ranges_copy.h>
1231#include <__algorithm/ranges_copy_backward.h>
1232#include <__algorithm/ranges_copy_if.h>
1233#include <__algorithm/ranges_copy_n.h>
Nikolas Klauserf1373d02022-04-07 13:02:02 +02001234#include <__algorithm/ranges_count.h>
1235#include <__algorithm/ranges_count_if.h>
Nikolas Klauser353f1dd2022-05-25 11:09:43 +02001236#include <__algorithm/ranges_equal.h>
Nikolas Klausereb49c2a2022-05-21 18:26:29 +02001237#include <__algorithm/ranges_fill.h>
1238#include <__algorithm/ranges_fill_n.h>
Nikolas Klauser37d076e2022-03-12 01:45:35 +01001239#include <__algorithm/ranges_find.h>
Nikolas Klauser0a7e46d2022-06-06 13:57:34 +02001240#include <__algorithm/ranges_find_first_of.h>
Nikolas Klauser37d076e2022-03-12 01:45:35 +01001241#include <__algorithm/ranges_find_if.h>
1242#include <__algorithm/ranges_find_if_not.h>
Nikolas Klauser58de98c2022-05-04 20:27:07 +02001243#include <__algorithm/ranges_for_each.h>
1244#include <__algorithm/ranges_for_each_n.h>
Nikolas Klauserbb9049d2022-05-04 14:19:09 +02001245#include <__algorithm/ranges_is_partitioned.h>
Nikolas Klauserab0b7af2022-05-26 16:08:55 +02001246#include <__algorithm/ranges_is_sorted.h>
1247#include <__algorithm/ranges_is_sorted_until.h>
Nikolas Klauser2fd677c2022-06-15 16:24:43 +02001248#include <__algorithm/ranges_lexicographical_compare.h>
Nikolas Klauser8b381972022-06-05 21:15:16 +02001249#include <__algorithm/ranges_lower_bound.h>
Nikolas Klauser573cd6f2022-04-03 09:17:01 +02001250#include <__algorithm/ranges_max.h>
Nikolas Klauserf2a69ea2022-03-07 17:01:52 +01001251#include <__algorithm/ranges_max_element.h>
Nikolas Klauser3559e452022-03-18 02:57:08 +01001252#include <__algorithm/ranges_min.h>
Nikolas Klauser0a62a172022-02-11 13:11:57 +01001253#include <__algorithm/ranges_min_element.h>
Nikolas Klauser0a2f44f2022-04-13 22:59:09 +02001254#include <__algorithm/ranges_minmax.h>
1255#include <__algorithm/ranges_minmax_element.h>
Nikolas Klauser12fc9bf2022-03-08 23:12:35 +01001256#include <__algorithm/ranges_mismatch.h>
Nikolas Klauser16661d82022-06-23 12:23:41 +02001257#include <__algorithm/ranges_move.h>
1258#include <__algorithm/ranges_move_backward.h>
Nikolas Klausered3f0e82022-05-26 16:42:46 +02001259#include <__algorithm/ranges_none_of.h>
Nikolas Klauserfadea392022-06-07 09:42:10 +02001260#include <__algorithm/ranges_replace.h>
1261#include <__algorithm/ranges_replace_if.h>
Nikolas Klauser52f20072022-05-24 10:32:50 +02001262#include <__algorithm/ranges_reverse.h>
Konstantin Varlamov55e39a82022-06-16 15:20:53 -07001263#include <__algorithm/ranges_sort.h>
Konstantin Varlamovdc3e7822022-07-01 16:34:08 -07001264#include <__algorithm/ranges_stable_sort.h>
Nikolas Klauser4ceab5f2022-02-10 13:33:03 +01001265#include <__algorithm/ranges_swap_ranges.h>
Nikolas Klauser559a1772022-04-05 11:05:36 +02001266#include <__algorithm/ranges_transform.h>
Nikolas Klauser8b381972022-06-05 21:15:16 +02001267#include <__algorithm/ranges_upper_bound.h>
Louis Dionnea60dd872021-06-17 11:30:11 -04001268#include <__algorithm/remove.h>
1269#include <__algorithm/remove_copy.h>
1270#include <__algorithm/remove_copy_if.h>
1271#include <__algorithm/remove_if.h>
1272#include <__algorithm/replace.h>
1273#include <__algorithm/replace_copy.h>
1274#include <__algorithm/replace_copy_if.h>
1275#include <__algorithm/replace_if.h>
1276#include <__algorithm/reverse.h>
1277#include <__algorithm/reverse_copy.h>
1278#include <__algorithm/rotate.h>
1279#include <__algorithm/rotate_copy.h>
1280#include <__algorithm/sample.h>
1281#include <__algorithm/search.h>
1282#include <__algorithm/search_n.h>
1283#include <__algorithm/set_difference.h>
1284#include <__algorithm/set_intersection.h>
1285#include <__algorithm/set_symmetric_difference.h>
1286#include <__algorithm/set_union.h>
1287#include <__algorithm/shift_left.h>
1288#include <__algorithm/shift_right.h>
1289#include <__algorithm/shuffle.h>
1290#include <__algorithm/sift_down.h>
1291#include <__algorithm/sort.h>
1292#include <__algorithm/sort_heap.h>
1293#include <__algorithm/stable_partition.h>
1294#include <__algorithm/stable_sort.h>
Christopher Di Bella41f26e82021-06-05 02:47:47 +00001295#include <__algorithm/swap_ranges.h>
Louis Dionnea60dd872021-06-17 11:30:11 -04001296#include <__algorithm/transform.h>
Louis Dionnea60dd872021-06-17 11:30:11 -04001297#include <__algorithm/unique.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -05001298#include <__algorithm/unique_copy.h>
Louis Dionnea60dd872021-06-17 11:30:11 -04001299#include <__algorithm/unwrap_iter.h>
1300#include <__algorithm/upper_bound.h>
Eric Fiselier14b6de92014-08-10 23:53:08 +00001301
Louis Dionne22355cc2022-06-27 15:53:41 -04001302#ifndef _LIBCPP_REMOVE_TRANSITIVE_INCLUDES
1303# include <chrono>
1304# include <iterator>
1305# include <utility>
1306#endif
1307
Nikolas Klausera0e0edb2022-06-16 22:43:46 +02001308// standard-mandated includes
1309#include <initializer_list>
1310
Howard Hinnantaaaa52b2011-10-17 20:05:10 +00001311#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
Arthur O'Dwyer6eeaa002022-02-01 20:16:40 -05001312# pragma GCC system_header
Howard Hinnantaaaa52b2011-10-17 20:05:10 +00001313#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +00001314
Louis Dionne59d0b3c2019-08-05 18:29:14 +00001315#if defined(_LIBCPP_HAS_PARALLEL_ALGORITHMS) && _LIBCPP_STD_VER >= 17
Louis Dionned53d8c02019-08-06 21:11:24 +00001316# include <__pstl_algorithm>
Louis Dionne59d0b3c2019-08-05 18:29:14 +00001317#endif
1318
Louis Dionne2b1ceaa2021-04-20 12:03:32 -04001319#endif // _LIBCPP_ALGORITHM