blob: 21c077637b9592b422df69e6bad7dfc331a51784 [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 {
22 template <class I1, class I2>
Nikolas Klauser05e2cd82022-01-25 11:21:47 +010023 struct in_in_result; // since C++20
24
25 template <class I1, class I2, class O>
26 struct in_in_out_result; // since C++20
Nikolas Klauser61ce8162022-02-03 02:17:03 +010027
28 template <class I, class O1, class O2>
29 struct in_out_out_result; // since C++20
Nikolas Klauserf74be4e2022-01-14 02:55:51 +010030}
31
Howard Hinnantc51e1022010-05-11 19:42:16 +000032template <class InputIterator, class Predicate>
Marshall Clowd607fdb2018-01-15 17:20:36 +000033 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000034 all_of(InputIterator first, InputIterator last, Predicate pred);
35
36template <class InputIterator, class Predicate>
Marshall Clowd607fdb2018-01-15 17:20:36 +000037 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000038 any_of(InputIterator first, InputIterator last, Predicate pred);
39
40template <class InputIterator, class Predicate>
Marshall Clowd607fdb2018-01-15 17:20:36 +000041 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000042 none_of(InputIterator first, InputIterator last, Predicate pred);
43
44template <class InputIterator, class Function>
Marshall Clow5492c8a2018-01-22 20:44:33 +000045 constexpr Function // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000046 for_each(InputIterator first, InputIterator last, Function f);
47
Marshall Clowde0169c2017-05-25 02:29:54 +000048template<class InputIterator, class Size, class Function>
Marshall Clow5492c8a2018-01-22 20:44:33 +000049 constexpr InputIterator // constexpr in C++20
50 for_each_n(InputIterator first, Size n, Function f); // C++17
Marshall Clowde0169c2017-05-25 02:29:54 +000051
Howard Hinnantc51e1022010-05-11 19:42:16 +000052template <class InputIterator, class T>
Marshall Clowee0161e2018-01-15 19:26:05 +000053 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000054 find(InputIterator first, InputIterator last, const T& value);
55
56template <class InputIterator, class Predicate>
Marshall Clowee0161e2018-01-15 19:26:05 +000057 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000058 find_if(InputIterator first, InputIterator last, Predicate pred);
59
60template<class InputIterator, class Predicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -050061 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000062 find_if_not(InputIterator first, InputIterator last, Predicate pred);
63
64template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -050065 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000066 find_end(ForwardIterator1 first1, ForwardIterator1 last1,
67 ForwardIterator2 first2, ForwardIterator2 last2);
68
69template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -050070 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000071 find_end(ForwardIterator1 first1, ForwardIterator1 last1,
72 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
73
74template <class ForwardIterator1, class ForwardIterator2>
Marshall Clowee0161e2018-01-15 19:26:05 +000075 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000076 find_first_of(ForwardIterator1 first1, ForwardIterator1 last1,
77 ForwardIterator2 first2, ForwardIterator2 last2);
78
79template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clowee0161e2018-01-15 19:26:05 +000080 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000081 find_first_of(ForwardIterator1 first1, ForwardIterator1 last1,
82 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
83
84template <class ForwardIterator>
Marshall Clowee0161e2018-01-15 19:26:05 +000085 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000086 adjacent_find(ForwardIterator first, ForwardIterator last);
87
88template <class ForwardIterator, class BinaryPredicate>
Marshall Clowee0161e2018-01-15 19:26:05 +000089 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000090 adjacent_find(ForwardIterator first, ForwardIterator last, BinaryPredicate pred);
91
92template <class InputIterator, class T>
Marshall Clow3c0558f2018-01-15 19:40:34 +000093 constexpr typename iterator_traits<InputIterator>::difference_type // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000094 count(InputIterator first, InputIterator last, const T& value);
95
96template <class InputIterator, class Predicate>
Marshall Clow3c0558f2018-01-15 19:40:34 +000097 constexpr typename iterator_traits<InputIterator>::difference_type // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000098 count_if(InputIterator first, InputIterator last, Predicate pred);
99
100template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000101 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000102 mismatch(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2);
103
Marshall Clow96b42b22013-05-09 21:14:23 +0000104template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000105 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Aditya Kumar3a0179a2016-08-25 11:52:38 +0000106 mismatch(InputIterator1 first1, InputIterator1 last1,
Marshall Clow96b42b22013-05-09 21:14:23 +0000107 InputIterator2 first2, InputIterator2 last2); // **C++14**
108
Howard Hinnantc51e1022010-05-11 19:42:16 +0000109template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000110 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000111 mismatch(InputIterator1 first1, InputIterator1 last1,
112 InputIterator2 first2, BinaryPredicate pred);
113
Marshall Clow96b42b22013-05-09 21:14:23 +0000114template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000115 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000116 mismatch(InputIterator1 first1, InputIterator1 last1,
117 InputIterator2 first2, InputIterator2 last2,
118 BinaryPredicate pred); // **C++14**
119
Howard Hinnantc51e1022010-05-11 19:42:16 +0000120template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000121 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000122 equal(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2);
123
Marshall Clow96b42b22013-05-09 21:14:23 +0000124template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000125 constexpr bool // constexpr in C++20
Aditya Kumar3a0179a2016-08-25 11:52:38 +0000126 equal(InputIterator1 first1, InputIterator1 last1,
Marshall Clow96b42b22013-05-09 21:14:23 +0000127 InputIterator2 first2, InputIterator2 last2); // **C++14**
128
Howard Hinnantc51e1022010-05-11 19:42:16 +0000129template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000130 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000131 equal(InputIterator1 first1, InputIterator1 last1,
132 InputIterator2 first2, BinaryPredicate pred);
133
Marshall Clow96b42b22013-05-09 21:14:23 +0000134template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000135 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000136 equal(InputIterator1 first1, InputIterator1 last1,
137 InputIterator2 first2, InputIterator2 last2,
138 BinaryPredicate pred); // **C++14**
139
Howard Hinnantc51e1022010-05-11 19:42:16 +0000140template<class ForwardIterator1, class ForwardIterator2>
Marshall Clow96d050a2018-01-15 16:16:32 +0000141 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000142 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
143 ForwardIterator2 first2);
144
Marshall Clow96b42b22013-05-09 21:14:23 +0000145template<class ForwardIterator1, class ForwardIterator2>
Marshall Clow96d050a2018-01-15 16:16:32 +0000146 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000147 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
148 ForwardIterator2 first2, ForwardIterator2 last2); // **C++14**
149
Howard Hinnantc51e1022010-05-11 19:42:16 +0000150template<class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000151 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000152 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
153 ForwardIterator2 first2, BinaryPredicate pred);
154
Marshall Clow96b42b22013-05-09 21:14:23 +0000155template<class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000156 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000157 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
158 ForwardIterator2 first2, ForwardIterator2 last2,
159 BinaryPredicate pred); // **C++14**
160
Howard Hinnantc51e1022010-05-11 19:42:16 +0000161template <class ForwardIterator1, class ForwardIterator2>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000162 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000163 search(ForwardIterator1 first1, ForwardIterator1 last1,
164 ForwardIterator2 first2, ForwardIterator2 last2);
165
166template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000167 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000168 search(ForwardIterator1 first1, ForwardIterator1 last1,
169 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
170
171template <class ForwardIterator, class Size, class T>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000172 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000173 search_n(ForwardIterator first, ForwardIterator last, Size count, const T& value);
174
175template <class ForwardIterator, class Size, class T, class BinaryPredicate>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000176 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000177 search_n(ForwardIterator first, ForwardIterator last,
178 Size count, const T& value, BinaryPredicate pred);
179
180template <class InputIterator, class OutputIterator>
Louis Dionne65b433b2019-11-06 12:02:41 +0000181 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000182 copy(InputIterator first, InputIterator last, OutputIterator result);
183
184template<class InputIterator, class OutputIterator, class Predicate>
Louis Dionne65b433b2019-11-06 12:02:41 +0000185 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000186 copy_if(InputIterator first, InputIterator last,
187 OutputIterator result, Predicate pred);
188
189template<class InputIterator, class Size, class OutputIterator>
Louis Dionne65b433b2019-11-06 12:02:41 +0000190 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000191 copy_n(InputIterator first, Size n, OutputIterator result);
192
193template <class BidirectionalIterator1, class BidirectionalIterator2>
Louis Dionne65b433b2019-11-06 12:02:41 +0000194 constexpr BidirectionalIterator2 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000195 copy_backward(BidirectionalIterator1 first, BidirectionalIterator1 last,
196 BidirectionalIterator2 result);
197
198template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500199 constexpr ForwardIterator2 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000200 swap_ranges(ForwardIterator1 first1, ForwardIterator1 last1, ForwardIterator2 first2);
201
Nikolas Klauser4ceab5f2022-02-10 13:33:03 +0100202template<input_iterator I1, sentinel_for<I1> S1, input_iterator I2, sentinel_for<I2> S2>
203 requires indirectly_swappable<I1, I2>
204 constexpr ranges::swap_ranges_result<I1, I2>
205 ranges::swap_ranges(I1 first1, S1 last1, I2 first2, S2 last2);
206
207template<input_range R1, input_range R2>
208 requires indirectly_swappable<iterator_t<R1>, iterator_t<R2>>
209 constexpr ranges::swap_ranges_result<borrowed_iterator_t<R1>, borrowed_iterator_t<R2>>
210 ranges::swap_ranges(R1&& r1, R2&& r2);
211
Howard Hinnantc51e1022010-05-11 19:42:16 +0000212template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500213 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000214 iter_swap(ForwardIterator1 a, ForwardIterator2 b);
215
216template <class InputIterator, class OutputIterator, class UnaryOperation>
Marshall Clow31427c62018-01-19 17:45:39 +0000217 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000218 transform(InputIterator first, InputIterator last, OutputIterator result, UnaryOperation op);
219
220template <class InputIterator1, class InputIterator2, class OutputIterator, class BinaryOperation>
Marshall Clow31427c62018-01-19 17:45:39 +0000221 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000222 transform(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2,
223 OutputIterator result, BinaryOperation binary_op);
224
225template <class ForwardIterator, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000226 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000227 replace(ForwardIterator first, ForwardIterator last, const T& old_value, const T& new_value);
228
229template <class ForwardIterator, class Predicate, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000230 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000231 replace_if(ForwardIterator first, ForwardIterator last, Predicate pred, const T& new_value);
232
233template <class InputIterator, class OutputIterator, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000234 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000235 replace_copy(InputIterator first, InputIterator last, OutputIterator result,
236 const T& old_value, const T& new_value);
237
238template <class InputIterator, class OutputIterator, class Predicate, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000239 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000240 replace_copy_if(InputIterator first, InputIterator last, OutputIterator result, Predicate pred, const T& new_value);
241
242template <class ForwardIterator, class T>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000243 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000244 fill(ForwardIterator first, ForwardIterator last, const T& value);
245
246template <class OutputIterator, class Size, class T>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000247 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000248 fill_n(OutputIterator first, Size n, const T& value);
249
250template <class ForwardIterator, class Generator>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000251 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000252 generate(ForwardIterator first, ForwardIterator last, Generator gen);
253
254template <class OutputIterator, class Size, class Generator>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000255 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000256 generate_n(OutputIterator first, Size n, Generator gen);
257
258template <class ForwardIterator, class T>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000259 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000260 remove(ForwardIterator first, ForwardIterator last, const T& value);
261
262template <class ForwardIterator, class Predicate>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000263 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000264 remove_if(ForwardIterator first, ForwardIterator last, Predicate pred);
265
266template <class InputIterator, class OutputIterator, class T>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000267 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000268 remove_copy(InputIterator first, InputIterator last, OutputIterator result, const T& value);
269
270template <class InputIterator, class OutputIterator, class Predicate>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000271 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000272 remove_copy_if(InputIterator first, InputIterator last, OutputIterator result, Predicate pred);
273
274template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500275 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000276 unique(ForwardIterator first, ForwardIterator last);
277
278template <class ForwardIterator, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500279 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000280 unique(ForwardIterator first, ForwardIterator last, BinaryPredicate pred);
281
282template <class InputIterator, class OutputIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500283 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000284 unique_copy(InputIterator first, InputIterator last, OutputIterator result);
285
286template <class InputIterator, class OutputIterator, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500287 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000288 unique_copy(InputIterator first, InputIterator last, OutputIterator result, BinaryPredicate pred);
289
290template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500291 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000292 reverse(BidirectionalIterator first, BidirectionalIterator last);
293
294template <class BidirectionalIterator, class OutputIterator>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000295 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000296 reverse_copy(BidirectionalIterator first, BidirectionalIterator last, OutputIterator result);
297
298template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500299 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000300 rotate(ForwardIterator first, ForwardIterator middle, ForwardIterator last);
301
302template <class ForwardIterator, class OutputIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500303 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000304 rotate_copy(ForwardIterator first, ForwardIterator middle, ForwardIterator last, OutputIterator result);
305
306template <class RandomAccessIterator>
307 void
Marshall Clowfac06e52017-03-23 13:43:37 +0000308 random_shuffle(RandomAccessIterator first, RandomAccessIterator last); // deprecated in C++14, removed in C++17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000309
310template <class RandomAccessIterator, class RandomNumberGenerator>
311 void
Marshall Clow83f35392014-03-03 06:14:19 +0000312 random_shuffle(RandomAccessIterator first, RandomAccessIterator last,
Marshall Clowfac06e52017-03-23 13:43:37 +0000313 RandomNumberGenerator& rand); // deprecated in C++14, removed in C++17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000314
Eric Fiselier1208fcd2016-08-28 22:14:37 +0000315template<class PopulationIterator, class SampleIterator,
316 class Distance, class UniformRandomBitGenerator>
317 SampleIterator sample(PopulationIterator first, PopulationIterator last,
318 SampleIterator out, Distance n,
319 UniformRandomBitGenerator&& g); // C++17
320
Howard Hinnant578ac0f2010-05-26 17:49:34 +0000321template<class RandomAccessIterator, class UniformRandomNumberGenerator>
322 void shuffle(RandomAccessIterator first, RandomAccessIterator last,
Howard Hinnanta5e71782010-11-18 01:47:02 +0000323 UniformRandomNumberGenerator&& g);
Howard Hinnant578ac0f2010-05-26 17:49:34 +0000324
Arthur O'Dwyercea050d2020-12-26 01:39:03 -0500325template<class ForwardIterator>
326 constexpr ForwardIterator
327 shift_left(ForwardIterator first, ForwardIterator last,
328 typename iterator_traits<ForwardIterator>::difference_type n); // C++20
329
330template<class ForwardIterator>
331 constexpr ForwardIterator
332 shift_right(ForwardIterator first, ForwardIterator last,
333 typename iterator_traits<ForwardIterator>::difference_type n); // C++20
334
Howard Hinnantc51e1022010-05-11 19:42:16 +0000335template <class InputIterator, class Predicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000336 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000337 is_partitioned(InputIterator first, InputIterator last, Predicate pred);
338
339template <class ForwardIterator, class Predicate>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500340 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000341 partition(ForwardIterator first, ForwardIterator last, Predicate pred);
342
343template <class InputIterator, class OutputIterator1,
344 class OutputIterator2, class Predicate>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000345 constexpr pair<OutputIterator1, OutputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000346 partition_copy(InputIterator first, InputIterator last,
347 OutputIterator1 out_true, OutputIterator2 out_false,
348 Predicate pred);
349
350template <class ForwardIterator, class Predicate>
351 ForwardIterator
352 stable_partition(ForwardIterator first, ForwardIterator last, Predicate pred);
353
354template<class ForwardIterator, class Predicate>
Marshall Clowe00916c2018-01-16 02:34:41 +0000355 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000356 partition_point(ForwardIterator first, ForwardIterator last, Predicate pred);
357
358template <class ForwardIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +0000359 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000360 is_sorted(ForwardIterator first, ForwardIterator last);
361
362template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500363 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000364 is_sorted(ForwardIterator first, ForwardIterator last, Compare comp);
365
366template<class ForwardIterator>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000367 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000368 is_sorted_until(ForwardIterator first, ForwardIterator last);
369
370template <class ForwardIterator, class Compare>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000371 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000372 is_sorted_until(ForwardIterator first, ForwardIterator last, Compare comp);
373
374template <class RandomAccessIterator>
Arthur O'Dwyer1bb0f672020-12-20 15:21:42 -0500375 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000376 sort(RandomAccessIterator first, RandomAccessIterator last);
377
378template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer1bb0f672020-12-20 15:21:42 -0500379 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000380 sort(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
381
382template <class RandomAccessIterator>
383 void
384 stable_sort(RandomAccessIterator first, RandomAccessIterator last);
385
386template <class RandomAccessIterator, class Compare>
387 void
388 stable_sort(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
389
390template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500391 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000392 partial_sort(RandomAccessIterator first, RandomAccessIterator middle, RandomAccessIterator last);
393
394template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500395 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000396 partial_sort(RandomAccessIterator first, RandomAccessIterator middle, RandomAccessIterator last, Compare comp);
397
398template <class InputIterator, class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500399 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000400 partial_sort_copy(InputIterator first, InputIterator last,
401 RandomAccessIterator result_first, RandomAccessIterator result_last);
402
403template <class InputIterator, class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500404 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000405 partial_sort_copy(InputIterator first, InputIterator last,
406 RandomAccessIterator result_first, RandomAccessIterator result_last, Compare comp);
407
408template <class RandomAccessIterator>
Arthur O'Dwyer4f5717b2021-02-04 18:12:52 -0500409 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000410 nth_element(RandomAccessIterator first, RandomAccessIterator nth, RandomAccessIterator last);
411
412template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer4f5717b2021-02-04 18:12:52 -0500413 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000414 nth_element(RandomAccessIterator first, RandomAccessIterator nth, RandomAccessIterator last, Compare comp);
415
416template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000417 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000418 lower_bound(ForwardIterator first, ForwardIterator last, const T& value);
419
420template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000421 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000422 lower_bound(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
423
424template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000425 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000426 upper_bound(ForwardIterator first, ForwardIterator last, const T& value);
427
428template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000429 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000430 upper_bound(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
431
432template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000433 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000434 equal_range(ForwardIterator first, ForwardIterator last, const T& value);
435
436template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000437 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000438 equal_range(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
439
440template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000441 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000442 binary_search(ForwardIterator first, ForwardIterator last, const T& value);
443
444template <class ForwardIterator, class T, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000445 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000446 binary_search(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
447
448template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500449 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000450 merge(InputIterator1 first1, InputIterator1 last1,
451 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
452
453template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500454 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000455 merge(InputIterator1 first1, InputIterator1 last1,
456 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
457
458template <class BidirectionalIterator>
459 void
460 inplace_merge(BidirectionalIterator first, BidirectionalIterator middle, BidirectionalIterator last);
461
462template <class BidirectionalIterator, class Compare>
463 void
464 inplace_merge(BidirectionalIterator first, BidirectionalIterator middle, BidirectionalIterator last, Compare comp);
465
466template <class InputIterator1, class InputIterator2>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000467 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000468 includes(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2);
469
470template <class InputIterator1, class InputIterator2, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000471 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000472 includes(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2, Compare comp);
473
474template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500475 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000476 set_union(InputIterator1 first1, InputIterator1 last1,
477 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
478
479template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500480 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000481 set_union(InputIterator1 first1, InputIterator1 last1,
482 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
483
484template <class InputIterator1, class InputIterator2, class OutputIterator>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000485 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000486 set_intersection(InputIterator1 first1, InputIterator1 last1,
487 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
488
489template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000490 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000491 set_intersection(InputIterator1 first1, InputIterator1 last1,
492 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
493
494template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500495 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000496 set_difference(InputIterator1 first1, InputIterator1 last1,
497 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
498
499template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500500 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000501 set_difference(InputIterator1 first1, InputIterator1 last1,
502 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
503
504template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500505 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000506 set_symmetric_difference(InputIterator1 first1, InputIterator1 last1,
507 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
508
509template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500510 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000511 set_symmetric_difference(InputIterator1 first1, InputIterator1 last1,
512 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
513
514template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500515 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000516 push_heap(RandomAccessIterator first, RandomAccessIterator last);
517
518template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500519 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000520 push_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
521
522template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500523 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000524 pop_heap(RandomAccessIterator first, RandomAccessIterator last);
525
526template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500527 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000528 pop_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
529
530template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500531 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000532 make_heap(RandomAccessIterator first, RandomAccessIterator last);
533
534template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500535 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000536 make_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
537
538template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500539 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000540 sort_heap(RandomAccessIterator first, RandomAccessIterator last);
541
542template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500543 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000544 sort_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
545
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000546template <class RandomAccessIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +0000547 constexpr bool // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000548 is_heap(RandomAccessIterator first, RandomAccessiterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000549
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000550template <class RandomAccessIterator, class Compare>
Marshall Clow96d050a2018-01-15 16:16:32 +0000551 constexpr bool // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000552 is_heap(RandomAccessIterator first, RandomAccessiterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000553
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000554template <class RandomAccessIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +0000555 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000556 is_heap_until(RandomAccessIterator first, RandomAccessiterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000557
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000558template <class RandomAccessIterator, class Compare>
Marshall Clow96d050a2018-01-15 16:16:32 +0000559 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000560 is_heap_until(RandomAccessIterator first, RandomAccessiterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000561
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000562template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500563 constexpr ForwardIterator // constexpr in C++14
564 min_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000565
566template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500567 constexpr ForwardIterator // constexpr in C++14
568 min_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000569
Howard Hinnantc51e1022010-05-11 19:42:16 +0000570template <class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500571 constexpr const T& // constexpr in C++14
572 min(const T& a, const T& b);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000573
574template <class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500575 constexpr const T& // constexpr in C++14
576 min(const T& a, const T& b, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000577
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000578template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500579 constexpr T // constexpr in C++14
580 min(initializer_list<T> t);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000581
582template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500583 constexpr T // constexpr in C++14
584 min(initializer_list<T> t, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000585
Marshall Clow3e18d0e2016-03-07 22:43:49 +0000586template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500587 constexpr const T& clamp(const T& v, const T& lo, const T& hi); // C++17
Marshall Clow3e18d0e2016-03-07 22:43:49 +0000588
589template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500590 constexpr const T& clamp(const T& v, const T& lo, const T& hi, Compare comp); // C++17
Marshall Clow3e18d0e2016-03-07 22:43:49 +0000591
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000592template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500593 constexpr ForwardIterator // constexpr in C++14
594 max_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000595
596template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500597 constexpr ForwardIterator // constexpr in C++14
598 max_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000599
Howard Hinnantc51e1022010-05-11 19:42:16 +0000600template <class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500601 constexpr const T& // constexpr in C++14
602 max(const T& a, const T& b);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000603
604template <class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500605 constexpr const T& // constexpr in C++14
606 max(const T& a, const T& b, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000607
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000608template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500609 constexpr T // constexpr in C++14
610 max(initializer_list<T> t);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000611
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000612template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500613 constexpr T // constexpr in C++14
614 max(initializer_list<T> t, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000615
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000616template<class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500617 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++14
618 minmax_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000619
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000620template<class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500621 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++14
622 minmax_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000623
624template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500625 constexpr pair<const T&, const T&> // constexpr in C++14
626 minmax(const T& a, const T& b);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000627
628template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500629 constexpr pair<const T&, const T&> // constexpr in C++14
630 minmax(const T& a, const T& b, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000631
632template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500633 constexpr pair<T, T> // constexpr in C++14
634 minmax(initializer_list<T> t);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000635
636template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500637 constexpr pair<T, T> // constexpr in C++14
638 minmax(initializer_list<T> t, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000639
640template <class InputIterator1, class InputIterator2>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000641 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000642 lexicographical_compare(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2);
643
644template <class InputIterator1, class InputIterator2, class Compare>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000645 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000646 lexicographical_compare(InputIterator1 first1, InputIterator1 last1,
647 InputIterator2 first2, InputIterator2 last2, Compare comp);
648
649template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500650 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000651 next_permutation(BidirectionalIterator first, BidirectionalIterator last);
652
653template <class BidirectionalIterator, class Compare>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500654 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000655 next_permutation(BidirectionalIterator first, BidirectionalIterator last, Compare comp);
656
657template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500658 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000659 prev_permutation(BidirectionalIterator first, BidirectionalIterator last);
660
661template <class BidirectionalIterator, class Compare>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500662 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000663 prev_permutation(BidirectionalIterator first, BidirectionalIterator last, Compare comp);
664
Konstantin Varlamov74736812022-01-10 22:49:37 -0800665namespace ranges {
666// [algorithms.results], algorithm result types
667template<class InputIterator, class OutputIterator>
668 struct in_out_result;
669}
670
Howard Hinnantc51e1022010-05-11 19:42:16 +0000671} // std
672
673*/
674
Arthur O'Dwyer3693d7a2022-02-04 13:09:30 -0500675#include <__bits>
Howard Hinnantc51e1022010-05-11 19:42:16 +0000676#include <__config>
Louis Dionnea60dd872021-06-17 11:30:11 -0400677#include <__debug>
Howard Hinnant60e5cf42012-07-26 17:09:09 +0000678#include <cstddef>
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400679#include <cstring>
680#include <functional>
681#include <initializer_list>
682#include <iterator>
683#include <memory>
684#include <type_traits>
Arthur O'Dwyer3693d7a2022-02-04 13:09:30 -0500685#include <utility>
Marshall Clow0a1e7502018-09-12 19:41:40 +0000686#include <version>
Howard Hinnantea382952013-08-14 18:00:20 +0000687
Louis Dionnea60dd872021-06-17 11:30:11 -0400688#include <__algorithm/adjacent_find.h>
689#include <__algorithm/all_of.h>
690#include <__algorithm/any_of.h>
691#include <__algorithm/binary_search.h>
692#include <__algorithm/clamp.h>
693#include <__algorithm/comp.h>
694#include <__algorithm/comp_ref_type.h>
695#include <__algorithm/copy.h>
696#include <__algorithm/copy_backward.h>
697#include <__algorithm/copy_if.h>
698#include <__algorithm/copy_n.h>
699#include <__algorithm/count.h>
700#include <__algorithm/count_if.h>
701#include <__algorithm/equal.h>
702#include <__algorithm/equal_range.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400703#include <__algorithm/fill.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -0500704#include <__algorithm/fill_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400705#include <__algorithm/find.h>
706#include <__algorithm/find_end.h>
707#include <__algorithm/find_first_of.h>
708#include <__algorithm/find_if.h>
709#include <__algorithm/find_if_not.h>
710#include <__algorithm/for_each.h>
711#include <__algorithm/for_each_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400712#include <__algorithm/generate.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -0500713#include <__algorithm/generate_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400714#include <__algorithm/half_positive.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