blob: 9149995caef7a0977469e7d8b14c88a1c31fd787 [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 {
Nikolas Klauser671b4752022-02-11 17:01:58 +010022 template <class I, class F>
Nikolas Klauser2e263162022-02-21 22:48:36 +010023 struct in_fun_result; // since C++20
Nikolas Klauser671b4752022-02-11 17:01:58 +010024
Nikolas Klauserf74be4e2022-01-14 02:55:51 +010025 template <class I1, class I2>
Nikolas Klauser2e263162022-02-21 22:48:36 +010026 struct in_in_result; // since C++20
Nikolas Klauser05e2cd82022-01-25 11:21:47 +010027
28 template <class I1, class I2, class O>
Nikolas Klauser2e263162022-02-21 22:48:36 +010029 struct in_in_out_result; // since C++20
Nikolas Klauser61ce8162022-02-03 02:17:03 +010030
31 template <class I, class O1, class O2>
32 struct in_out_out_result; // since C++20
Nikolas Klauser671b4752022-02-11 17:01:58 +010033
Nikolas Klauser2e263162022-02-21 22:48:36 +010034 template <class I1, class I2>
35 struct min_max_result; // since C++20
36
Nikolas Klauser0a62a172022-02-11 13:11:57 +010037 template<forward_iterator I, sentinel_for<I> S, class Proj = identity,
38 indirect_strict_weak_order<projected<I, Proj>> Comp = ranges::less> // since C++20
39 constexpr I min_element(I first, S last, Comp comp = {}, Proj proj = {});
40
41 template<forward_range R, class Proj = identity,
42 indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less> // since C++20
43 constexpr borrowed_iterator_t<R> min_element(R&& r, Comp comp = {}, Proj proj = {});
Nikolas Klauserf74be4e2022-01-14 02:55:51 +010044}
45
Howard Hinnantc51e1022010-05-11 19:42:16 +000046template <class InputIterator, class Predicate>
Marshall Clowd607fdb2018-01-15 17:20:36 +000047 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000048 all_of(InputIterator first, InputIterator last, Predicate pred);
49
50template <class InputIterator, class Predicate>
Marshall Clowd607fdb2018-01-15 17:20:36 +000051 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000052 any_of(InputIterator first, InputIterator last, Predicate pred);
53
54template <class InputIterator, class Predicate>
Marshall Clowd607fdb2018-01-15 17:20:36 +000055 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000056 none_of(InputIterator first, InputIterator last, Predicate pred);
57
58template <class InputIterator, class Function>
Marshall Clow5492c8a2018-01-22 20:44:33 +000059 constexpr Function // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000060 for_each(InputIterator first, InputIterator last, Function f);
61
Marshall Clowde0169c2017-05-25 02:29:54 +000062template<class InputIterator, class Size, class Function>
Marshall Clow5492c8a2018-01-22 20:44:33 +000063 constexpr InputIterator // constexpr in C++20
64 for_each_n(InputIterator first, Size n, Function f); // C++17
Marshall Clowde0169c2017-05-25 02:29:54 +000065
Howard Hinnantc51e1022010-05-11 19:42:16 +000066template <class InputIterator, class T>
Marshall Clowee0161e2018-01-15 19:26:05 +000067 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000068 find(InputIterator first, InputIterator last, const T& value);
69
70template <class InputIterator, class Predicate>
Marshall Clowee0161e2018-01-15 19:26:05 +000071 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000072 find_if(InputIterator first, InputIterator last, Predicate pred);
73
74template<class InputIterator, class Predicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -050075 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000076 find_if_not(InputIterator first, InputIterator last, Predicate pred);
77
78template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -050079 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000080 find_end(ForwardIterator1 first1, ForwardIterator1 last1,
81 ForwardIterator2 first2, ForwardIterator2 last2);
82
83template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -050084 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000085 find_end(ForwardIterator1 first1, ForwardIterator1 last1,
86 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
87
88template <class ForwardIterator1, class ForwardIterator2>
Marshall Clowee0161e2018-01-15 19:26:05 +000089 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000090 find_first_of(ForwardIterator1 first1, ForwardIterator1 last1,
91 ForwardIterator2 first2, ForwardIterator2 last2);
92
93template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clowee0161e2018-01-15 19:26:05 +000094 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000095 find_first_of(ForwardIterator1 first1, ForwardIterator1 last1,
96 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
97
98template <class ForwardIterator>
Marshall Clowee0161e2018-01-15 19:26:05 +000099 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000100 adjacent_find(ForwardIterator first, ForwardIterator last);
101
102template <class ForwardIterator, class BinaryPredicate>
Marshall Clowee0161e2018-01-15 19:26:05 +0000103 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000104 adjacent_find(ForwardIterator first, ForwardIterator last, BinaryPredicate pred);
105
106template <class InputIterator, class T>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000107 constexpr typename iterator_traits<InputIterator>::difference_type // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000108 count(InputIterator first, InputIterator last, const T& value);
109
110template <class InputIterator, class Predicate>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000111 constexpr typename iterator_traits<InputIterator>::difference_type // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000112 count_if(InputIterator first, InputIterator last, Predicate pred);
113
114template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000115 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000116 mismatch(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2);
117
Marshall Clow96b42b22013-05-09 21:14:23 +0000118template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000119 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Aditya Kumar3a0179a2016-08-25 11:52:38 +0000120 mismatch(InputIterator1 first1, InputIterator1 last1,
Marshall Clow96b42b22013-05-09 21:14:23 +0000121 InputIterator2 first2, InputIterator2 last2); // **C++14**
122
Howard Hinnantc51e1022010-05-11 19:42:16 +0000123template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000124 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000125 mismatch(InputIterator1 first1, InputIterator1 last1,
126 InputIterator2 first2, BinaryPredicate pred);
127
Marshall Clow96b42b22013-05-09 21:14:23 +0000128template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000129 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000130 mismatch(InputIterator1 first1, InputIterator1 last1,
131 InputIterator2 first2, InputIterator2 last2,
132 BinaryPredicate pred); // **C++14**
133
Howard Hinnantc51e1022010-05-11 19:42:16 +0000134template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000135 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000136 equal(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2);
137
Marshall Clow96b42b22013-05-09 21:14:23 +0000138template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000139 constexpr bool // constexpr in C++20
Aditya Kumar3a0179a2016-08-25 11:52:38 +0000140 equal(InputIterator1 first1, InputIterator1 last1,
Marshall Clow96b42b22013-05-09 21:14:23 +0000141 InputIterator2 first2, InputIterator2 last2); // **C++14**
142
Howard Hinnantc51e1022010-05-11 19:42:16 +0000143template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000144 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000145 equal(InputIterator1 first1, InputIterator1 last1,
146 InputIterator2 first2, BinaryPredicate pred);
147
Marshall Clow96b42b22013-05-09 21:14:23 +0000148template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000149 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000150 equal(InputIterator1 first1, InputIterator1 last1,
151 InputIterator2 first2, InputIterator2 last2,
152 BinaryPredicate pred); // **C++14**
153
Howard Hinnantc51e1022010-05-11 19:42:16 +0000154template<class ForwardIterator1, class ForwardIterator2>
Marshall Clow96d050a2018-01-15 16:16:32 +0000155 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000156 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
157 ForwardIterator2 first2);
158
Marshall Clow96b42b22013-05-09 21:14:23 +0000159template<class ForwardIterator1, class ForwardIterator2>
Marshall Clow96d050a2018-01-15 16:16:32 +0000160 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000161 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
162 ForwardIterator2 first2, ForwardIterator2 last2); // **C++14**
163
Howard Hinnantc51e1022010-05-11 19:42:16 +0000164template<class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000165 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000166 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
167 ForwardIterator2 first2, BinaryPredicate pred);
168
Marshall Clow96b42b22013-05-09 21:14:23 +0000169template<class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000170 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000171 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
172 ForwardIterator2 first2, ForwardIterator2 last2,
173 BinaryPredicate pred); // **C++14**
174
Howard Hinnantc51e1022010-05-11 19:42:16 +0000175template <class ForwardIterator1, class ForwardIterator2>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000176 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000177 search(ForwardIterator1 first1, ForwardIterator1 last1,
178 ForwardIterator2 first2, ForwardIterator2 last2);
179
180template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000181 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000182 search(ForwardIterator1 first1, ForwardIterator1 last1,
183 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
184
185template <class ForwardIterator, class Size, class T>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000186 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000187 search_n(ForwardIterator first, ForwardIterator last, Size count, const T& value);
188
189template <class ForwardIterator, class Size, class T, class BinaryPredicate>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000190 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000191 search_n(ForwardIterator first, ForwardIterator last,
192 Size count, const T& value, BinaryPredicate pred);
193
194template <class InputIterator, class OutputIterator>
Louis Dionne65b433b2019-11-06 12:02:41 +0000195 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000196 copy(InputIterator first, InputIterator last, OutputIterator result);
197
198template<class InputIterator, class OutputIterator, class Predicate>
Louis Dionne65b433b2019-11-06 12:02:41 +0000199 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000200 copy_if(InputIterator first, InputIterator last,
201 OutputIterator result, Predicate pred);
202
203template<class InputIterator, class Size, class OutputIterator>
Louis Dionne65b433b2019-11-06 12:02:41 +0000204 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000205 copy_n(InputIterator first, Size n, OutputIterator result);
206
207template <class BidirectionalIterator1, class BidirectionalIterator2>
Louis Dionne65b433b2019-11-06 12:02:41 +0000208 constexpr BidirectionalIterator2 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000209 copy_backward(BidirectionalIterator1 first, BidirectionalIterator1 last,
210 BidirectionalIterator2 result);
211
212template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500213 constexpr ForwardIterator2 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000214 swap_ranges(ForwardIterator1 first1, ForwardIterator1 last1, ForwardIterator2 first2);
215
Nikolas Klauser4ceab5f2022-02-10 13:33:03 +0100216template<input_iterator I1, sentinel_for<I1> S1, input_iterator I2, sentinel_for<I2> S2>
217 requires indirectly_swappable<I1, I2>
218 constexpr ranges::swap_ranges_result<I1, I2>
219 ranges::swap_ranges(I1 first1, S1 last1, I2 first2, S2 last2);
220
221template<input_range R1, input_range R2>
222 requires indirectly_swappable<iterator_t<R1>, iterator_t<R2>>
223 constexpr ranges::swap_ranges_result<borrowed_iterator_t<R1>, borrowed_iterator_t<R2>>
224 ranges::swap_ranges(R1&& r1, R2&& r2);
225
Howard Hinnantc51e1022010-05-11 19:42:16 +0000226template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500227 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000228 iter_swap(ForwardIterator1 a, ForwardIterator2 b);
229
230template <class InputIterator, class OutputIterator, class UnaryOperation>
Marshall Clow31427c62018-01-19 17:45:39 +0000231 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000232 transform(InputIterator first, InputIterator last, OutputIterator result, UnaryOperation op);
233
234template <class InputIterator1, class InputIterator2, class OutputIterator, class BinaryOperation>
Marshall Clow31427c62018-01-19 17:45:39 +0000235 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000236 transform(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2,
237 OutputIterator result, BinaryOperation binary_op);
238
239template <class ForwardIterator, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000240 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000241 replace(ForwardIterator first, ForwardIterator last, const T& old_value, const T& new_value);
242
243template <class ForwardIterator, class Predicate, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000244 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000245 replace_if(ForwardIterator first, ForwardIterator last, Predicate pred, const T& new_value);
246
247template <class InputIterator, class OutputIterator, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000248 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000249 replace_copy(InputIterator first, InputIterator last, OutputIterator result,
250 const T& old_value, const T& new_value);
251
252template <class InputIterator, class OutputIterator, class Predicate, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000253 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000254 replace_copy_if(InputIterator first, InputIterator last, OutputIterator result, Predicate pred, const T& new_value);
255
256template <class ForwardIterator, class T>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000257 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000258 fill(ForwardIterator first, ForwardIterator last, const T& value);
259
260template <class OutputIterator, class Size, class T>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000261 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000262 fill_n(OutputIterator first, Size n, const T& value);
263
264template <class ForwardIterator, class Generator>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000265 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000266 generate(ForwardIterator first, ForwardIterator last, Generator gen);
267
268template <class OutputIterator, class Size, class Generator>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000269 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000270 generate_n(OutputIterator first, Size n, Generator gen);
271
272template <class ForwardIterator, class T>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000273 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000274 remove(ForwardIterator first, ForwardIterator last, const T& value);
275
276template <class ForwardIterator, class Predicate>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000277 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000278 remove_if(ForwardIterator first, ForwardIterator last, Predicate pred);
279
280template <class InputIterator, class OutputIterator, class T>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000281 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000282 remove_copy(InputIterator first, InputIterator last, OutputIterator result, const T& value);
283
284template <class InputIterator, class OutputIterator, class Predicate>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000285 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000286 remove_copy_if(InputIterator first, InputIterator last, OutputIterator result, Predicate pred);
287
288template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500289 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000290 unique(ForwardIterator first, ForwardIterator last);
291
292template <class ForwardIterator, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500293 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000294 unique(ForwardIterator first, ForwardIterator last, BinaryPredicate pred);
295
296template <class InputIterator, class OutputIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500297 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000298 unique_copy(InputIterator first, InputIterator last, OutputIterator result);
299
300template <class InputIterator, class OutputIterator, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500301 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000302 unique_copy(InputIterator first, InputIterator last, OutputIterator result, BinaryPredicate pred);
303
304template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500305 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000306 reverse(BidirectionalIterator first, BidirectionalIterator last);
307
308template <class BidirectionalIterator, class OutputIterator>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000309 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000310 reverse_copy(BidirectionalIterator first, BidirectionalIterator last, OutputIterator result);
311
312template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500313 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000314 rotate(ForwardIterator first, ForwardIterator middle, ForwardIterator last);
315
316template <class ForwardIterator, class OutputIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500317 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000318 rotate_copy(ForwardIterator first, ForwardIterator middle, ForwardIterator last, OutputIterator result);
319
320template <class RandomAccessIterator>
321 void
Marshall Clowfac06e52017-03-23 13:43:37 +0000322 random_shuffle(RandomAccessIterator first, RandomAccessIterator last); // deprecated in C++14, removed in C++17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000323
324template <class RandomAccessIterator, class RandomNumberGenerator>
325 void
Marshall Clow83f35392014-03-03 06:14:19 +0000326 random_shuffle(RandomAccessIterator first, RandomAccessIterator last,
Marshall Clowfac06e52017-03-23 13:43:37 +0000327 RandomNumberGenerator& rand); // deprecated in C++14, removed in C++17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000328
Eric Fiselier1208fcd2016-08-28 22:14:37 +0000329template<class PopulationIterator, class SampleIterator,
330 class Distance, class UniformRandomBitGenerator>
331 SampleIterator sample(PopulationIterator first, PopulationIterator last,
332 SampleIterator out, Distance n,
333 UniformRandomBitGenerator&& g); // C++17
334
Howard Hinnant578ac0f2010-05-26 17:49:34 +0000335template<class RandomAccessIterator, class UniformRandomNumberGenerator>
336 void shuffle(RandomAccessIterator first, RandomAccessIterator last,
Howard Hinnanta5e71782010-11-18 01:47:02 +0000337 UniformRandomNumberGenerator&& g);
Howard Hinnant578ac0f2010-05-26 17:49:34 +0000338
Arthur O'Dwyercea050d2020-12-26 01:39:03 -0500339template<class ForwardIterator>
340 constexpr ForwardIterator
341 shift_left(ForwardIterator first, ForwardIterator last,
342 typename iterator_traits<ForwardIterator>::difference_type n); // C++20
343
344template<class ForwardIterator>
345 constexpr ForwardIterator
346 shift_right(ForwardIterator first, ForwardIterator last,
347 typename iterator_traits<ForwardIterator>::difference_type n); // C++20
348
Howard Hinnantc51e1022010-05-11 19:42:16 +0000349template <class InputIterator, class Predicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000350 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000351 is_partitioned(InputIterator first, InputIterator last, Predicate pred);
352
353template <class ForwardIterator, class Predicate>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500354 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000355 partition(ForwardIterator first, ForwardIterator last, Predicate pred);
356
357template <class InputIterator, class OutputIterator1,
358 class OutputIterator2, class Predicate>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000359 constexpr pair<OutputIterator1, OutputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000360 partition_copy(InputIterator first, InputIterator last,
361 OutputIterator1 out_true, OutputIterator2 out_false,
362 Predicate pred);
363
364template <class ForwardIterator, class Predicate>
365 ForwardIterator
366 stable_partition(ForwardIterator first, ForwardIterator last, Predicate pred);
367
368template<class ForwardIterator, class Predicate>
Marshall Clowe00916c2018-01-16 02:34:41 +0000369 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000370 partition_point(ForwardIterator first, ForwardIterator last, Predicate pred);
371
372template <class ForwardIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +0000373 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000374 is_sorted(ForwardIterator first, ForwardIterator last);
375
376template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500377 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000378 is_sorted(ForwardIterator first, ForwardIterator last, Compare comp);
379
380template<class ForwardIterator>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000381 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000382 is_sorted_until(ForwardIterator first, ForwardIterator last);
383
384template <class ForwardIterator, class Compare>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000385 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000386 is_sorted_until(ForwardIterator first, ForwardIterator last, Compare comp);
387
388template <class RandomAccessIterator>
Arthur O'Dwyer1bb0f672020-12-20 15:21:42 -0500389 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000390 sort(RandomAccessIterator first, RandomAccessIterator last);
391
392template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer1bb0f672020-12-20 15:21:42 -0500393 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000394 sort(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
395
396template <class RandomAccessIterator>
397 void
398 stable_sort(RandomAccessIterator first, RandomAccessIterator last);
399
400template <class RandomAccessIterator, class Compare>
401 void
402 stable_sort(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
403
404template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500405 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000406 partial_sort(RandomAccessIterator first, RandomAccessIterator middle, RandomAccessIterator last);
407
408template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500409 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000410 partial_sort(RandomAccessIterator first, RandomAccessIterator middle, RandomAccessIterator last, Compare comp);
411
412template <class InputIterator, class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500413 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000414 partial_sort_copy(InputIterator first, InputIterator last,
415 RandomAccessIterator result_first, RandomAccessIterator result_last);
416
417template <class InputIterator, class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500418 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000419 partial_sort_copy(InputIterator first, InputIterator last,
420 RandomAccessIterator result_first, RandomAccessIterator result_last, Compare comp);
421
422template <class RandomAccessIterator>
Arthur O'Dwyer4f5717b2021-02-04 18:12:52 -0500423 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000424 nth_element(RandomAccessIterator first, RandomAccessIterator nth, RandomAccessIterator last);
425
426template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer4f5717b2021-02-04 18:12:52 -0500427 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000428 nth_element(RandomAccessIterator first, RandomAccessIterator nth, RandomAccessIterator last, Compare comp);
429
430template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000431 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000432 lower_bound(ForwardIterator first, ForwardIterator last, const T& value);
433
434template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000435 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000436 lower_bound(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
437
438template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000439 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000440 upper_bound(ForwardIterator first, ForwardIterator last, const T& value);
441
442template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000443 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000444 upper_bound(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
445
446template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000447 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000448 equal_range(ForwardIterator first, ForwardIterator last, const T& value);
449
450template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000451 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000452 equal_range(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
453
454template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000455 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000456 binary_search(ForwardIterator first, ForwardIterator last, const T& value);
457
458template <class ForwardIterator, class T, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000459 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000460 binary_search(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
461
462template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500463 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000464 merge(InputIterator1 first1, InputIterator1 last1,
465 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
466
467template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500468 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000469 merge(InputIterator1 first1, InputIterator1 last1,
470 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
471
472template <class BidirectionalIterator>
473 void
474 inplace_merge(BidirectionalIterator first, BidirectionalIterator middle, BidirectionalIterator last);
475
476template <class BidirectionalIterator, class Compare>
477 void
478 inplace_merge(BidirectionalIterator first, BidirectionalIterator middle, BidirectionalIterator last, Compare comp);
479
480template <class InputIterator1, class InputIterator2>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000481 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000482 includes(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2);
483
484template <class InputIterator1, class InputIterator2, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000485 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000486 includes(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2, Compare comp);
487
488template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500489 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000490 set_union(InputIterator1 first1, InputIterator1 last1,
491 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
492
493template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500494 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000495 set_union(InputIterator1 first1, InputIterator1 last1,
496 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
497
498template <class InputIterator1, class InputIterator2, class OutputIterator>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000499 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000500 set_intersection(InputIterator1 first1, InputIterator1 last1,
501 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
502
503template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000504 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000505 set_intersection(InputIterator1 first1, InputIterator1 last1,
506 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
507
508template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500509 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000510 set_difference(InputIterator1 first1, InputIterator1 last1,
511 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
512
513template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500514 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000515 set_difference(InputIterator1 first1, InputIterator1 last1,
516 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
517
518template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500519 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000520 set_symmetric_difference(InputIterator1 first1, InputIterator1 last1,
521 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
522
523template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500524 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000525 set_symmetric_difference(InputIterator1 first1, InputIterator1 last1,
526 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
527
528template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500529 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000530 push_heap(RandomAccessIterator first, RandomAccessIterator last);
531
532template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500533 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000534 push_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
535
536template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500537 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000538 pop_heap(RandomAccessIterator first, RandomAccessIterator last);
539
540template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500541 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000542 pop_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
543
544template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500545 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000546 make_heap(RandomAccessIterator first, RandomAccessIterator last);
547
548template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500549 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000550 make_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
551
552template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500553 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000554 sort_heap(RandomAccessIterator first, RandomAccessIterator last);
555
556template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500557 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000558 sort_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
559
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000560template <class RandomAccessIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +0000561 constexpr bool // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000562 is_heap(RandomAccessIterator first, RandomAccessiterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000563
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000564template <class RandomAccessIterator, class Compare>
Marshall Clow96d050a2018-01-15 16:16:32 +0000565 constexpr bool // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000566 is_heap(RandomAccessIterator first, RandomAccessiterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000567
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000568template <class RandomAccessIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +0000569 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000570 is_heap_until(RandomAccessIterator first, RandomAccessiterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000571
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000572template <class RandomAccessIterator, class Compare>
Marshall Clow96d050a2018-01-15 16:16:32 +0000573 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000574 is_heap_until(RandomAccessIterator first, RandomAccessiterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000575
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000576template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500577 constexpr ForwardIterator // constexpr in C++14
578 min_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000579
580template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500581 constexpr ForwardIterator // constexpr in C++14
582 min_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000583
Howard Hinnantc51e1022010-05-11 19:42:16 +0000584template <class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500585 constexpr const T& // constexpr in C++14
586 min(const T& a, const T& b);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000587
588template <class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500589 constexpr const T& // constexpr in C++14
590 min(const T& a, const T& b, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000591
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000592template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500593 constexpr T // constexpr in C++14
594 min(initializer_list<T> t);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000595
596template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500597 constexpr T // constexpr in C++14
598 min(initializer_list<T> t, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000599
Marshall Clow3e18d0e2016-03-07 22:43:49 +0000600template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500601 constexpr const T& clamp(const T& v, const T& lo, const T& hi); // C++17
Marshall Clow3e18d0e2016-03-07 22:43:49 +0000602
603template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500604 constexpr const T& clamp(const T& v, const T& lo, const T& hi, Compare comp); // C++17
Marshall Clow3e18d0e2016-03-07 22:43:49 +0000605
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000606template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500607 constexpr ForwardIterator // constexpr in C++14
608 max_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000609
610template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500611 constexpr ForwardIterator // constexpr in C++14
612 max_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000613
Howard Hinnantc51e1022010-05-11 19:42:16 +0000614template <class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500615 constexpr const T& // constexpr in C++14
616 max(const T& a, const T& b);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000617
618template <class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500619 constexpr const T& // constexpr in C++14
620 max(const T& a, const T& b, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000621
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000622template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500623 constexpr T // constexpr in C++14
624 max(initializer_list<T> t);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000625
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000626template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500627 constexpr T // constexpr in C++14
628 max(initializer_list<T> t, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000629
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000630template<class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500631 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++14
632 minmax_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000633
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000634template<class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500635 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++14
636 minmax_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000637
638template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500639 constexpr pair<const T&, const T&> // constexpr in C++14
640 minmax(const T& a, const T& b);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000641
642template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500643 constexpr pair<const T&, const T&> // constexpr in C++14
644 minmax(const T& a, const T& b, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000645
646template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500647 constexpr pair<T, T> // constexpr in C++14
648 minmax(initializer_list<T> t);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000649
650template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500651 constexpr pair<T, T> // constexpr in C++14
652 minmax(initializer_list<T> t, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000653
654template <class InputIterator1, class InputIterator2>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000655 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000656 lexicographical_compare(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2);
657
658template <class InputIterator1, class InputIterator2, class Compare>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000659 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000660 lexicographical_compare(InputIterator1 first1, InputIterator1 last1,
661 InputIterator2 first2, InputIterator2 last2, Compare comp);
662
663template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500664 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000665 next_permutation(BidirectionalIterator first, BidirectionalIterator last);
666
667template <class BidirectionalIterator, class Compare>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500668 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000669 next_permutation(BidirectionalIterator first, BidirectionalIterator last, Compare comp);
670
671template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500672 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000673 prev_permutation(BidirectionalIterator first, BidirectionalIterator last);
674
675template <class BidirectionalIterator, class Compare>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500676 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000677 prev_permutation(BidirectionalIterator first, BidirectionalIterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000678} // std
679
680*/
681
Arthur O'Dwyer3693d7a2022-02-04 13:09:30 -0500682#include <__bits>
Howard Hinnantc51e1022010-05-11 19:42:16 +0000683#include <__config>
Louis Dionnea60dd872021-06-17 11:30:11 -0400684#include <__debug>
Howard Hinnant60e5cf42012-07-26 17:09:09 +0000685#include <cstddef>
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400686#include <cstring>
687#include <functional>
688#include <initializer_list>
689#include <iterator>
690#include <memory>
691#include <type_traits>
Arthur O'Dwyer3693d7a2022-02-04 13:09:30 -0500692#include <utility>
Marshall Clow0a1e7502018-09-12 19:41:40 +0000693#include <version>
Howard Hinnantea382952013-08-14 18:00:20 +0000694
Louis Dionnea60dd872021-06-17 11:30:11 -0400695#include <__algorithm/adjacent_find.h>
696#include <__algorithm/all_of.h>
697#include <__algorithm/any_of.h>
698#include <__algorithm/binary_search.h>
699#include <__algorithm/clamp.h>
700#include <__algorithm/comp.h>
701#include <__algorithm/comp_ref_type.h>
702#include <__algorithm/copy.h>
703#include <__algorithm/copy_backward.h>
704#include <__algorithm/copy_if.h>
705#include <__algorithm/copy_n.h>
706#include <__algorithm/count.h>
707#include <__algorithm/count_if.h>
708#include <__algorithm/equal.h>
709#include <__algorithm/equal_range.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400710#include <__algorithm/fill.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -0500711#include <__algorithm/fill_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400712#include <__algorithm/find.h>
713#include <__algorithm/find_end.h>
714#include <__algorithm/find_first_of.h>
715#include <__algorithm/find_if.h>
716#include <__algorithm/find_if_not.h>
717#include <__algorithm/for_each.h>
718#include <__algorithm/for_each_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400719#include <__algorithm/generate.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -0500720#include <__algorithm/generate_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400721#include <__algorithm/half_positive.h>
Nikolas Klauser671b4752022-02-11 17:01:58 +0100722#include <__algorithm/in_fun_result.h>
Nikolas Klauser05e2cd82022-01-25 11:21:47 +0100723#include <__algorithm/in_in_out_result.h>
Nikolas Klauserf74be4e2022-01-14 02:55:51 +0100724#include <__algorithm/in_in_result.h>
Nikolas Klauser61ce8162022-02-03 02:17:03 +0100725#include <__algorithm/in_out_out_result.h>
Konstantin Varlamov74736812022-01-10 22:49:37 -0800726#include <__algorithm/in_out_result.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400727#include <__algorithm/includes.h>
728#include <__algorithm/inplace_merge.h>
729#include <__algorithm/is_heap.h>
730#include <__algorithm/is_heap_until.h>
731#include <__algorithm/is_partitioned.h>
732#include <__algorithm/is_permutation.h>
733#include <__algorithm/is_sorted.h>
734#include <__algorithm/is_sorted_until.h>
Christopher Di Bella41f26e82021-06-05 02:47:47 +0000735#include <__algorithm/iter_swap.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400736#include <__algorithm/lexicographical_compare.h>
737#include <__algorithm/lower_bound.h>
738#include <__algorithm/make_heap.h>
739#include <__algorithm/max.h>
740#include <__algorithm/max_element.h>
741#include <__algorithm/merge.h>
742#include <__algorithm/min.h>
743#include <__algorithm/min_element.h>
Nikolas Klauser2e263162022-02-21 22:48:36 +0100744#include <__algorithm/min_max_result.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400745#include <__algorithm/minmax.h>
746#include <__algorithm/minmax_element.h>
747#include <__algorithm/mismatch.h>
748#include <__algorithm/move.h>
749#include <__algorithm/move_backward.h>
750#include <__algorithm/next_permutation.h>
751#include <__algorithm/none_of.h>
752#include <__algorithm/nth_element.h>
753#include <__algorithm/partial_sort.h>
754#include <__algorithm/partial_sort_copy.h>
755#include <__algorithm/partition.h>
756#include <__algorithm/partition_copy.h>
757#include <__algorithm/partition_point.h>
758#include <__algorithm/pop_heap.h>
759#include <__algorithm/prev_permutation.h>
760#include <__algorithm/push_heap.h>
Nikolas Klauser0a62a172022-02-11 13:11:57 +0100761#include <__algorithm/ranges_min_element.h>
Nikolas Klauser4ceab5f2022-02-10 13:33:03 +0100762#include <__algorithm/ranges_swap_ranges.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400763#include <__algorithm/remove.h>
764#include <__algorithm/remove_copy.h>
765#include <__algorithm/remove_copy_if.h>
766#include <__algorithm/remove_if.h>
767#include <__algorithm/replace.h>
768#include <__algorithm/replace_copy.h>
769#include <__algorithm/replace_copy_if.h>
770#include <__algorithm/replace_if.h>
771#include <__algorithm/reverse.h>
772#include <__algorithm/reverse_copy.h>
773#include <__algorithm/rotate.h>
774#include <__algorithm/rotate_copy.h>
775#include <__algorithm/sample.h>
776#include <__algorithm/search.h>
777#include <__algorithm/search_n.h>
778#include <__algorithm/set_difference.h>
779#include <__algorithm/set_intersection.h>
780#include <__algorithm/set_symmetric_difference.h>
781#include <__algorithm/set_union.h>
782#include <__algorithm/shift_left.h>
783#include <__algorithm/shift_right.h>
784#include <__algorithm/shuffle.h>
785#include <__algorithm/sift_down.h>
786#include <__algorithm/sort.h>
787#include <__algorithm/sort_heap.h>
788#include <__algorithm/stable_partition.h>
789#include <__algorithm/stable_sort.h>
Christopher Di Bella41f26e82021-06-05 02:47:47 +0000790#include <__algorithm/swap_ranges.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400791#include <__algorithm/transform.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400792#include <__algorithm/unique.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -0500793#include <__algorithm/unique_copy.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400794#include <__algorithm/unwrap_iter.h>
795#include <__algorithm/upper_bound.h>
Eric Fiselier14b6de92014-08-10 23:53:08 +0000796
Howard Hinnantaaaa52b2011-10-17 20:05:10 +0000797#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
Arthur O'Dwyer6eeaa002022-02-01 20:16:40 -0500798# pragma GCC system_header
Howard Hinnantaaaa52b2011-10-17 20:05:10 +0000799#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +0000800
Louis Dionne59d0b3c2019-08-05 18:29:14 +0000801#if defined(_LIBCPP_HAS_PARALLEL_ALGORITHMS) && _LIBCPP_STD_VER >= 17
Louis Dionned53d8c02019-08-06 21:11:24 +0000802# include <__pstl_algorithm>
Louis Dionne59d0b3c2019-08-05 18:29:14 +0000803#endif
804
Louis Dionne2b1ceaa2021-04-20 12:03:32 -0400805#endif // _LIBCPP_ALGORITHM