blob: be10e3065f2f079d84a184f76448f52e2e41e60f [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>
23 struct in_fun_result; // since C++20
24
Nikolas Klauserf74be4e2022-01-14 02:55:51 +010025 template <class I1, class I2>
Nikolas Klauser05e2cd82022-01-25 11:21:47 +010026 struct in_in_result; // since C++20
27
28 template <class I1, class I2, class O>
29 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
34 template<class I, class O>
35 struct in_out_result; // since C++20
Nikolas Klauserf74be4e2022-01-14 02:55:51 +010036}
37
Howard Hinnantc51e1022010-05-11 19:42:16 +000038template <class InputIterator, class Predicate>
Marshall Clowd607fdb2018-01-15 17:20:36 +000039 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000040 all_of(InputIterator first, InputIterator last, Predicate pred);
41
42template <class InputIterator, class Predicate>
Marshall Clowd607fdb2018-01-15 17:20:36 +000043 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000044 any_of(InputIterator first, InputIterator last, Predicate pred);
45
46template <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 none_of(InputIterator first, InputIterator last, Predicate pred);
49
50template <class InputIterator, class Function>
Marshall Clow5492c8a2018-01-22 20:44:33 +000051 constexpr Function // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000052 for_each(InputIterator first, InputIterator last, Function f);
53
Marshall Clowde0169c2017-05-25 02:29:54 +000054template<class InputIterator, class Size, class Function>
Marshall Clow5492c8a2018-01-22 20:44:33 +000055 constexpr InputIterator // constexpr in C++20
56 for_each_n(InputIterator first, Size n, Function f); // C++17
Marshall Clowde0169c2017-05-25 02:29:54 +000057
Howard Hinnantc51e1022010-05-11 19:42:16 +000058template <class InputIterator, class T>
Marshall Clowee0161e2018-01-15 19:26:05 +000059 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000060 find(InputIterator first, InputIterator last, const T& value);
61
62template <class InputIterator, class Predicate>
Marshall Clowee0161e2018-01-15 19:26:05 +000063 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000064 find_if(InputIterator first, InputIterator last, Predicate pred);
65
66template<class InputIterator, class Predicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -050067 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000068 find_if_not(InputIterator first, InputIterator last, Predicate pred);
69
70template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -050071 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000072 find_end(ForwardIterator1 first1, ForwardIterator1 last1,
73 ForwardIterator2 first2, ForwardIterator2 last2);
74
75template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -050076 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000077 find_end(ForwardIterator1 first1, ForwardIterator1 last1,
78 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
79
80template <class ForwardIterator1, class ForwardIterator2>
Marshall Clowee0161e2018-01-15 19:26:05 +000081 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000082 find_first_of(ForwardIterator1 first1, ForwardIterator1 last1,
83 ForwardIterator2 first2, ForwardIterator2 last2);
84
85template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clowee0161e2018-01-15 19:26:05 +000086 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000087 find_first_of(ForwardIterator1 first1, ForwardIterator1 last1,
88 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
89
90template <class ForwardIterator>
Marshall Clowee0161e2018-01-15 19:26:05 +000091 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000092 adjacent_find(ForwardIterator first, ForwardIterator last);
93
94template <class ForwardIterator, class BinaryPredicate>
Marshall Clowee0161e2018-01-15 19:26:05 +000095 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000096 adjacent_find(ForwardIterator first, ForwardIterator last, BinaryPredicate pred);
97
98template <class InputIterator, class T>
Marshall Clow3c0558f2018-01-15 19:40:34 +000099 constexpr typename iterator_traits<InputIterator>::difference_type // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000100 count(InputIterator first, InputIterator last, const T& value);
101
102template <class InputIterator, class Predicate>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000103 constexpr typename iterator_traits<InputIterator>::difference_type // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000104 count_if(InputIterator first, InputIterator last, Predicate pred);
105
106template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000107 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000108 mismatch(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2);
109
Marshall Clow96b42b22013-05-09 21:14:23 +0000110template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000111 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Aditya Kumar3a0179a2016-08-25 11:52:38 +0000112 mismatch(InputIterator1 first1, InputIterator1 last1,
Marshall Clow96b42b22013-05-09 21:14:23 +0000113 InputIterator2 first2, InputIterator2 last2); // **C++14**
114
Howard Hinnantc51e1022010-05-11 19:42:16 +0000115template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000116 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000117 mismatch(InputIterator1 first1, InputIterator1 last1,
118 InputIterator2 first2, BinaryPredicate pred);
119
Marshall Clow96b42b22013-05-09 21:14:23 +0000120template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000121 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000122 mismatch(InputIterator1 first1, InputIterator1 last1,
123 InputIterator2 first2, InputIterator2 last2,
124 BinaryPredicate pred); // **C++14**
125
Howard Hinnantc51e1022010-05-11 19:42:16 +0000126template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000127 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000128 equal(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2);
129
Marshall Clow96b42b22013-05-09 21:14:23 +0000130template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000131 constexpr bool // constexpr in C++20
Aditya Kumar3a0179a2016-08-25 11:52:38 +0000132 equal(InputIterator1 first1, InputIterator1 last1,
Marshall Clow96b42b22013-05-09 21:14:23 +0000133 InputIterator2 first2, InputIterator2 last2); // **C++14**
134
Howard Hinnantc51e1022010-05-11 19:42:16 +0000135template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000136 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000137 equal(InputIterator1 first1, InputIterator1 last1,
138 InputIterator2 first2, BinaryPredicate pred);
139
Marshall Clow96b42b22013-05-09 21:14:23 +0000140template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000141 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000142 equal(InputIterator1 first1, InputIterator1 last1,
143 InputIterator2 first2, InputIterator2 last2,
144 BinaryPredicate pred); // **C++14**
145
Howard Hinnantc51e1022010-05-11 19:42:16 +0000146template<class ForwardIterator1, class ForwardIterator2>
Marshall Clow96d050a2018-01-15 16:16:32 +0000147 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000148 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
149 ForwardIterator2 first2);
150
Marshall Clow96b42b22013-05-09 21:14:23 +0000151template<class ForwardIterator1, class ForwardIterator2>
Marshall Clow96d050a2018-01-15 16:16:32 +0000152 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000153 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
154 ForwardIterator2 first2, ForwardIterator2 last2); // **C++14**
155
Howard Hinnantc51e1022010-05-11 19:42:16 +0000156template<class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000157 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000158 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
159 ForwardIterator2 first2, BinaryPredicate pred);
160
Marshall Clow96b42b22013-05-09 21:14:23 +0000161template<class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000162 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000163 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
164 ForwardIterator2 first2, ForwardIterator2 last2,
165 BinaryPredicate pred); // **C++14**
166
Howard Hinnantc51e1022010-05-11 19:42:16 +0000167template <class ForwardIterator1, class ForwardIterator2>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000168 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000169 search(ForwardIterator1 first1, ForwardIterator1 last1,
170 ForwardIterator2 first2, ForwardIterator2 last2);
171
172template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000173 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000174 search(ForwardIterator1 first1, ForwardIterator1 last1,
175 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
176
177template <class ForwardIterator, class Size, class T>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000178 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000179 search_n(ForwardIterator first, ForwardIterator last, Size count, const T& value);
180
181template <class ForwardIterator, class Size, class T, class BinaryPredicate>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000182 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000183 search_n(ForwardIterator first, ForwardIterator last,
184 Size count, const T& value, BinaryPredicate pred);
185
186template <class InputIterator, class OutputIterator>
Louis Dionne65b433b2019-11-06 12:02:41 +0000187 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000188 copy(InputIterator first, InputIterator last, OutputIterator result);
189
190template<class InputIterator, class OutputIterator, class Predicate>
Louis Dionne65b433b2019-11-06 12:02:41 +0000191 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000192 copy_if(InputIterator first, InputIterator last,
193 OutputIterator result, Predicate pred);
194
195template<class InputIterator, class Size, class OutputIterator>
Louis Dionne65b433b2019-11-06 12:02:41 +0000196 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000197 copy_n(InputIterator first, Size n, OutputIterator result);
198
199template <class BidirectionalIterator1, class BidirectionalIterator2>
Louis Dionne65b433b2019-11-06 12:02:41 +0000200 constexpr BidirectionalIterator2 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000201 copy_backward(BidirectionalIterator1 first, BidirectionalIterator1 last,
202 BidirectionalIterator2 result);
203
204template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500205 constexpr ForwardIterator2 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000206 swap_ranges(ForwardIterator1 first1, ForwardIterator1 last1, ForwardIterator2 first2);
207
Nikolas Klauser4ceab5f2022-02-10 13:33:03 +0100208template<input_iterator I1, sentinel_for<I1> S1, input_iterator I2, sentinel_for<I2> S2>
209 requires indirectly_swappable<I1, I2>
210 constexpr ranges::swap_ranges_result<I1, I2>
211 ranges::swap_ranges(I1 first1, S1 last1, I2 first2, S2 last2);
212
213template<input_range R1, input_range R2>
214 requires indirectly_swappable<iterator_t<R1>, iterator_t<R2>>
215 constexpr ranges::swap_ranges_result<borrowed_iterator_t<R1>, borrowed_iterator_t<R2>>
216 ranges::swap_ranges(R1&& r1, R2&& r2);
217
Howard Hinnantc51e1022010-05-11 19:42:16 +0000218template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500219 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000220 iter_swap(ForwardIterator1 a, ForwardIterator2 b);
221
222template <class InputIterator, class OutputIterator, class UnaryOperation>
Marshall Clow31427c62018-01-19 17:45:39 +0000223 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000224 transform(InputIterator first, InputIterator last, OutputIterator result, UnaryOperation op);
225
226template <class InputIterator1, class InputIterator2, class OutputIterator, class BinaryOperation>
Marshall Clow31427c62018-01-19 17:45:39 +0000227 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000228 transform(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2,
229 OutputIterator result, BinaryOperation binary_op);
230
231template <class ForwardIterator, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000232 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000233 replace(ForwardIterator first, ForwardIterator last, const T& old_value, const T& new_value);
234
235template <class ForwardIterator, class Predicate, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000236 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000237 replace_if(ForwardIterator first, ForwardIterator last, Predicate pred, const T& new_value);
238
239template <class InputIterator, class OutputIterator, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000240 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000241 replace_copy(InputIterator first, InputIterator last, OutputIterator result,
242 const T& old_value, const T& new_value);
243
244template <class InputIterator, class OutputIterator, class Predicate, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000245 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000246 replace_copy_if(InputIterator first, InputIterator last, OutputIterator result, Predicate pred, const T& new_value);
247
248template <class ForwardIterator, class T>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000249 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000250 fill(ForwardIterator first, ForwardIterator last, const T& value);
251
252template <class OutputIterator, class Size, class T>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000253 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000254 fill_n(OutputIterator first, Size n, const T& value);
255
256template <class ForwardIterator, class Generator>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000257 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000258 generate(ForwardIterator first, ForwardIterator last, Generator gen);
259
260template <class OutputIterator, class Size, class Generator>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000261 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000262 generate_n(OutputIterator first, Size n, Generator gen);
263
264template <class ForwardIterator, class T>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000265 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000266 remove(ForwardIterator first, ForwardIterator last, const T& value);
267
268template <class ForwardIterator, class Predicate>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000269 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000270 remove_if(ForwardIterator first, ForwardIterator last, Predicate pred);
271
272template <class InputIterator, class OutputIterator, class T>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000273 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000274 remove_copy(InputIterator first, InputIterator last, OutputIterator result, const T& value);
275
276template <class InputIterator, class OutputIterator, class Predicate>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000277 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000278 remove_copy_if(InputIterator first, InputIterator last, OutputIterator result, Predicate pred);
279
280template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500281 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000282 unique(ForwardIterator first, ForwardIterator last);
283
284template <class ForwardIterator, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500285 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000286 unique(ForwardIterator first, ForwardIterator last, BinaryPredicate pred);
287
288template <class InputIterator, class OutputIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500289 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000290 unique_copy(InputIterator first, InputIterator last, OutputIterator result);
291
292template <class InputIterator, class OutputIterator, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500293 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000294 unique_copy(InputIterator first, InputIterator last, OutputIterator result, BinaryPredicate pred);
295
296template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500297 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000298 reverse(BidirectionalIterator first, BidirectionalIterator last);
299
300template <class BidirectionalIterator, class OutputIterator>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000301 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000302 reverse_copy(BidirectionalIterator first, BidirectionalIterator last, OutputIterator result);
303
304template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500305 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000306 rotate(ForwardIterator first, ForwardIterator middle, ForwardIterator last);
307
308template <class ForwardIterator, class OutputIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500309 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000310 rotate_copy(ForwardIterator first, ForwardIterator middle, ForwardIterator last, OutputIterator result);
311
312template <class RandomAccessIterator>
313 void
Marshall Clowfac06e52017-03-23 13:43:37 +0000314 random_shuffle(RandomAccessIterator first, RandomAccessIterator last); // deprecated in C++14, removed in C++17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000315
316template <class RandomAccessIterator, class RandomNumberGenerator>
317 void
Marshall Clow83f35392014-03-03 06:14:19 +0000318 random_shuffle(RandomAccessIterator first, RandomAccessIterator last,
Marshall Clowfac06e52017-03-23 13:43:37 +0000319 RandomNumberGenerator& rand); // deprecated in C++14, removed in C++17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000320
Eric Fiselier1208fcd2016-08-28 22:14:37 +0000321template<class PopulationIterator, class SampleIterator,
322 class Distance, class UniformRandomBitGenerator>
323 SampleIterator sample(PopulationIterator first, PopulationIterator last,
324 SampleIterator out, Distance n,
325 UniformRandomBitGenerator&& g); // C++17
326
Howard Hinnant578ac0f2010-05-26 17:49:34 +0000327template<class RandomAccessIterator, class UniformRandomNumberGenerator>
328 void shuffle(RandomAccessIterator first, RandomAccessIterator last,
Howard Hinnanta5e71782010-11-18 01:47:02 +0000329 UniformRandomNumberGenerator&& g);
Howard Hinnant578ac0f2010-05-26 17:49:34 +0000330
Arthur O'Dwyercea050d2020-12-26 01:39:03 -0500331template<class ForwardIterator>
332 constexpr ForwardIterator
333 shift_left(ForwardIterator first, ForwardIterator last,
334 typename iterator_traits<ForwardIterator>::difference_type n); // C++20
335
336template<class ForwardIterator>
337 constexpr ForwardIterator
338 shift_right(ForwardIterator first, ForwardIterator last,
339 typename iterator_traits<ForwardIterator>::difference_type n); // C++20
340
Howard Hinnantc51e1022010-05-11 19:42:16 +0000341template <class InputIterator, class Predicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000342 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000343 is_partitioned(InputIterator first, InputIterator last, Predicate pred);
344
345template <class ForwardIterator, class Predicate>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500346 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000347 partition(ForwardIterator first, ForwardIterator last, Predicate pred);
348
349template <class InputIterator, class OutputIterator1,
350 class OutputIterator2, class Predicate>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000351 constexpr pair<OutputIterator1, OutputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000352 partition_copy(InputIterator first, InputIterator last,
353 OutputIterator1 out_true, OutputIterator2 out_false,
354 Predicate pred);
355
356template <class ForwardIterator, class Predicate>
357 ForwardIterator
358 stable_partition(ForwardIterator first, ForwardIterator last, Predicate pred);
359
360template<class ForwardIterator, class Predicate>
Marshall Clowe00916c2018-01-16 02:34:41 +0000361 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000362 partition_point(ForwardIterator first, ForwardIterator last, Predicate pred);
363
364template <class ForwardIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +0000365 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000366 is_sorted(ForwardIterator first, ForwardIterator last);
367
368template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500369 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000370 is_sorted(ForwardIterator first, ForwardIterator last, Compare comp);
371
372template<class ForwardIterator>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000373 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000374 is_sorted_until(ForwardIterator first, ForwardIterator last);
375
376template <class ForwardIterator, class Compare>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000377 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000378 is_sorted_until(ForwardIterator first, ForwardIterator last, Compare comp);
379
380template <class RandomAccessIterator>
Arthur O'Dwyer1bb0f672020-12-20 15:21:42 -0500381 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000382 sort(RandomAccessIterator first, RandomAccessIterator last);
383
384template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer1bb0f672020-12-20 15:21:42 -0500385 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000386 sort(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
387
388template <class RandomAccessIterator>
389 void
390 stable_sort(RandomAccessIterator first, RandomAccessIterator last);
391
392template <class RandomAccessIterator, class Compare>
393 void
394 stable_sort(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
395
396template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500397 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000398 partial_sort(RandomAccessIterator first, RandomAccessIterator middle, RandomAccessIterator last);
399
400template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500401 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000402 partial_sort(RandomAccessIterator first, RandomAccessIterator middle, RandomAccessIterator last, Compare comp);
403
404template <class InputIterator, class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500405 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000406 partial_sort_copy(InputIterator first, InputIterator last,
407 RandomAccessIterator result_first, RandomAccessIterator result_last);
408
409template <class InputIterator, class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500410 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000411 partial_sort_copy(InputIterator first, InputIterator last,
412 RandomAccessIterator result_first, RandomAccessIterator result_last, Compare comp);
413
414template <class RandomAccessIterator>
Arthur O'Dwyer4f5717b2021-02-04 18:12:52 -0500415 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000416 nth_element(RandomAccessIterator first, RandomAccessIterator nth, RandomAccessIterator last);
417
418template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer4f5717b2021-02-04 18:12:52 -0500419 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000420 nth_element(RandomAccessIterator first, RandomAccessIterator nth, RandomAccessIterator last, Compare comp);
421
422template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000423 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000424 lower_bound(ForwardIterator first, ForwardIterator last, const T& value);
425
426template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000427 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000428 lower_bound(ForwardIterator first, ForwardIterator last, const T& value, 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 upper_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 upper_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 pair<ForwardIterator, ForwardIterator> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000440 equal_range(ForwardIterator first, ForwardIterator last, const T& value);
441
442template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000443 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000444 equal_range(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
445
446template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000447 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000448 binary_search(ForwardIterator first, ForwardIterator last, const T& value);
449
450template <class ForwardIterator, class T, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000451 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000452 binary_search(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
453
454template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500455 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000456 merge(InputIterator1 first1, InputIterator1 last1,
457 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
458
459template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500460 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000461 merge(InputIterator1 first1, InputIterator1 last1,
462 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
463
464template <class BidirectionalIterator>
465 void
466 inplace_merge(BidirectionalIterator first, BidirectionalIterator middle, BidirectionalIterator last);
467
468template <class BidirectionalIterator, class Compare>
469 void
470 inplace_merge(BidirectionalIterator first, BidirectionalIterator middle, BidirectionalIterator last, Compare comp);
471
472template <class InputIterator1, class InputIterator2>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000473 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000474 includes(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2);
475
476template <class InputIterator1, class InputIterator2, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000477 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000478 includes(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2, Compare comp);
479
480template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500481 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000482 set_union(InputIterator1 first1, InputIterator1 last1,
483 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
484
485template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500486 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000487 set_union(InputIterator1 first1, InputIterator1 last1,
488 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
489
490template <class InputIterator1, class InputIterator2, class OutputIterator>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000491 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000492 set_intersection(InputIterator1 first1, InputIterator1 last1,
493 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
494
495template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000496 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000497 set_intersection(InputIterator1 first1, InputIterator1 last1,
498 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
499
500template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500501 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000502 set_difference(InputIterator1 first1, InputIterator1 last1,
503 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
504
505template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500506 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000507 set_difference(InputIterator1 first1, InputIterator1 last1,
508 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
509
510template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500511 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000512 set_symmetric_difference(InputIterator1 first1, InputIterator1 last1,
513 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
514
515template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500516 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000517 set_symmetric_difference(InputIterator1 first1, InputIterator1 last1,
518 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
519
520template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500521 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000522 push_heap(RandomAccessIterator first, RandomAccessIterator last);
523
524template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500525 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000526 push_heap(RandomAccessIterator first, RandomAccessIterator last, 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 pop_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 pop_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 make_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 make_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 sort_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 sort_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
551
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000552template <class RandomAccessIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +0000553 constexpr bool // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000554 is_heap(RandomAccessIterator first, RandomAccessiterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000555
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000556template <class RandomAccessIterator, class Compare>
Marshall Clow96d050a2018-01-15 16:16:32 +0000557 constexpr bool // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000558 is_heap(RandomAccessIterator first, RandomAccessiterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000559
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000560template <class RandomAccessIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +0000561 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000562 is_heap_until(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 RandomAccessIterator // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000566 is_heap_until(RandomAccessIterator first, RandomAccessiterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000567
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000568template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500569 constexpr ForwardIterator // constexpr in C++14
570 min_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000571
572template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500573 constexpr ForwardIterator // constexpr in C++14
574 min_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000575
Howard Hinnantc51e1022010-05-11 19:42:16 +0000576template <class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500577 constexpr const T& // constexpr in C++14
578 min(const T& a, const T& b);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000579
580template <class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500581 constexpr const T& // constexpr in C++14
582 min(const T& a, const T& b, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000583
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000584template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500585 constexpr T // constexpr in C++14
586 min(initializer_list<T> t);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000587
588template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500589 constexpr T // constexpr in C++14
590 min(initializer_list<T> t, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000591
Marshall Clow3e18d0e2016-03-07 22:43:49 +0000592template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500593 constexpr const T& clamp(const T& v, const T& lo, const T& hi); // C++17
Marshall Clow3e18d0e2016-03-07 22:43:49 +0000594
595template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500596 constexpr const T& clamp(const T& v, const T& lo, const T& hi, Compare comp); // C++17
Marshall Clow3e18d0e2016-03-07 22:43:49 +0000597
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000598template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500599 constexpr ForwardIterator // constexpr in C++14
600 max_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000601
602template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500603 constexpr ForwardIterator // constexpr in C++14
604 max_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000605
Howard Hinnantc51e1022010-05-11 19:42:16 +0000606template <class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500607 constexpr const T& // constexpr in C++14
608 max(const T& a, const T& b);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000609
610template <class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500611 constexpr const T& // constexpr in C++14
612 max(const T& a, const T& b, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000613
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000614template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500615 constexpr T // constexpr in C++14
616 max(initializer_list<T> t);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000617
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000618template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500619 constexpr T // constexpr in C++14
620 max(initializer_list<T> t, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000621
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000622template<class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500623 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++14
624 minmax_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000625
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000626template<class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500627 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++14
628 minmax_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000629
630template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500631 constexpr pair<const T&, const T&> // constexpr in C++14
632 minmax(const T& a, const T& b);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000633
634template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500635 constexpr pair<const T&, const T&> // constexpr in C++14
636 minmax(const T& a, const T& b, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000637
638template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500639 constexpr pair<T, T> // constexpr in C++14
640 minmax(initializer_list<T> t);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000641
642template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500643 constexpr pair<T, T> // constexpr in C++14
644 minmax(initializer_list<T> t, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000645
646template <class InputIterator1, class InputIterator2>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000647 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000648 lexicographical_compare(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2);
649
650template <class InputIterator1, class InputIterator2, class Compare>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000651 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000652 lexicographical_compare(InputIterator1 first1, InputIterator1 last1,
653 InputIterator2 first2, InputIterator2 last2, Compare comp);
654
655template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500656 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000657 next_permutation(BidirectionalIterator first, BidirectionalIterator last);
658
659template <class BidirectionalIterator, class Compare>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500660 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000661 next_permutation(BidirectionalIterator first, BidirectionalIterator last, 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 prev_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 prev_permutation(BidirectionalIterator first, BidirectionalIterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000670} // std
671
672*/
673
Arthur O'Dwyer3693d7a2022-02-04 13:09:30 -0500674#include <__bits>
Howard Hinnantc51e1022010-05-11 19:42:16 +0000675#include <__config>
Louis Dionnea60dd872021-06-17 11:30:11 -0400676#include <__debug>
Howard Hinnant60e5cf42012-07-26 17:09:09 +0000677#include <cstddef>
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400678#include <cstring>
679#include <functional>
680#include <initializer_list>
681#include <iterator>
682#include <memory>
683#include <type_traits>
Arthur O'Dwyer3693d7a2022-02-04 13:09:30 -0500684#include <utility>
Marshall Clow0a1e7502018-09-12 19:41:40 +0000685#include <version>
Howard Hinnantea382952013-08-14 18:00:20 +0000686
Louis Dionnea60dd872021-06-17 11:30:11 -0400687#include <__algorithm/adjacent_find.h>
688#include <__algorithm/all_of.h>
689#include <__algorithm/any_of.h>
690#include <__algorithm/binary_search.h>
691#include <__algorithm/clamp.h>
692#include <__algorithm/comp.h>
693#include <__algorithm/comp_ref_type.h>
694#include <__algorithm/copy.h>
695#include <__algorithm/copy_backward.h>
696#include <__algorithm/copy_if.h>
697#include <__algorithm/copy_n.h>
698#include <__algorithm/count.h>
699#include <__algorithm/count_if.h>
700#include <__algorithm/equal.h>
701#include <__algorithm/equal_range.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400702#include <__algorithm/fill.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -0500703#include <__algorithm/fill_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400704#include <__algorithm/find.h>
705#include <__algorithm/find_end.h>
706#include <__algorithm/find_first_of.h>
707#include <__algorithm/find_if.h>
708#include <__algorithm/find_if_not.h>
709#include <__algorithm/for_each.h>
710#include <__algorithm/for_each_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400711#include <__algorithm/generate.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -0500712#include <__algorithm/generate_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400713#include <__algorithm/half_positive.h>
Nikolas Klauser671b4752022-02-11 17:01:58 +0100714#include <__algorithm/in_fun_result.h>
Nikolas Klauser05e2cd82022-01-25 11:21:47 +0100715#include <__algorithm/in_in_out_result.h>
Nikolas Klauserf74be4e2022-01-14 02:55:51 +0100716#include <__algorithm/in_in_result.h>
Nikolas Klauser61ce8162022-02-03 02:17:03 +0100717#include <__algorithm/in_out_out_result.h>
Konstantin Varlamov74736812022-01-10 22:49:37 -0800718#include <__algorithm/in_out_result.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400719#include <__algorithm/includes.h>
720#include <__algorithm/inplace_merge.h>
721#include <__algorithm/is_heap.h>
722#include <__algorithm/is_heap_until.h>
723#include <__algorithm/is_partitioned.h>
724#include <__algorithm/is_permutation.h>
725#include <__algorithm/is_sorted.h>
726#include <__algorithm/is_sorted_until.h>
Christopher Di Bella41f26e82021-06-05 02:47:47 +0000727#include <__algorithm/iter_swap.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400728#include <__algorithm/lexicographical_compare.h>
729#include <__algorithm/lower_bound.h>
730#include <__algorithm/make_heap.h>
731#include <__algorithm/max.h>
732#include <__algorithm/max_element.h>
733#include <__algorithm/merge.h>
734#include <__algorithm/min.h>
735#include <__algorithm/min_element.h>
736#include <__algorithm/minmax.h>
737#include <__algorithm/minmax_element.h>
738#include <__algorithm/mismatch.h>
739#include <__algorithm/move.h>
740#include <__algorithm/move_backward.h>
741#include <__algorithm/next_permutation.h>
742#include <__algorithm/none_of.h>
743#include <__algorithm/nth_element.h>
744#include <__algorithm/partial_sort.h>
745#include <__algorithm/partial_sort_copy.h>
746#include <__algorithm/partition.h>
747#include <__algorithm/partition_copy.h>
748#include <__algorithm/partition_point.h>
749#include <__algorithm/pop_heap.h>
750#include <__algorithm/prev_permutation.h>
751#include <__algorithm/push_heap.h>
Nikolas Klauser4ceab5f2022-02-10 13:33:03 +0100752#include <__algorithm/ranges_swap_ranges.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400753#include <__algorithm/remove.h>
754#include <__algorithm/remove_copy.h>
755#include <__algorithm/remove_copy_if.h>
756#include <__algorithm/remove_if.h>
757#include <__algorithm/replace.h>
758#include <__algorithm/replace_copy.h>
759#include <__algorithm/replace_copy_if.h>
760#include <__algorithm/replace_if.h>
761#include <__algorithm/reverse.h>
762#include <__algorithm/reverse_copy.h>
763#include <__algorithm/rotate.h>
764#include <__algorithm/rotate_copy.h>
765#include <__algorithm/sample.h>
766#include <__algorithm/search.h>
767#include <__algorithm/search_n.h>
768#include <__algorithm/set_difference.h>
769#include <__algorithm/set_intersection.h>
770#include <__algorithm/set_symmetric_difference.h>
771#include <__algorithm/set_union.h>
772#include <__algorithm/shift_left.h>
773#include <__algorithm/shift_right.h>
774#include <__algorithm/shuffle.h>
775#include <__algorithm/sift_down.h>
776#include <__algorithm/sort.h>
777#include <__algorithm/sort_heap.h>
778#include <__algorithm/stable_partition.h>
779#include <__algorithm/stable_sort.h>
Christopher Di Bella41f26e82021-06-05 02:47:47 +0000780#include <__algorithm/swap_ranges.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400781#include <__algorithm/transform.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400782#include <__algorithm/unique.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -0500783#include <__algorithm/unique_copy.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400784#include <__algorithm/unwrap_iter.h>
785#include <__algorithm/upper_bound.h>
Eric Fiselier14b6de92014-08-10 23:53:08 +0000786
Howard Hinnantaaaa52b2011-10-17 20:05:10 +0000787#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
Arthur O'Dwyer6eeaa002022-02-01 20:16:40 -0500788# pragma GCC system_header
Howard Hinnantaaaa52b2011-10-17 20:05:10 +0000789#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +0000790
Louis Dionne59d0b3c2019-08-05 18:29:14 +0000791#if defined(_LIBCPP_HAS_PARALLEL_ALGORITHMS) && _LIBCPP_STD_VER >= 17
Louis Dionned53d8c02019-08-06 21:11:24 +0000792# include <__pstl_algorithm>
Louis Dionne59d0b3c2019-08-05 18:29:14 +0000793#endif
794
Louis Dionne2b1ceaa2021-04-20 12:03:32 -0400795#endif // _LIBCPP_ALGORITHM