blob: 8bff2069c43088d9bc6d6658de7ce225e97c143f [file] [log] [blame]
Howard Hinnantc51e1022010-05-11 19:42:16 +00001// -*- C++ -*-
Louis Dionne9bd93882021-11-17 16:25:01 -05002//===----------------------------------------------------------------------===//
Howard Hinnantc51e1022010-05-11 19:42:16 +00003//
Chandler Carruthd2012102019-01-19 10:56:40 +00004// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
5// See https://llvm.org/LICENSE.txt for license information.
6// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
Howard Hinnantc51e1022010-05-11 19:42:16 +00007//
8//===----------------------------------------------------------------------===//
9
10#ifndef _LIBCPP_ALGORITHM
11#define _LIBCPP_ALGORITHM
12
13/*
14 algorithm synopsis
15
16#include <initializer_list>
17
18namespace std
19{
20
Nikolas Klauserf74be4e2022-01-14 02:55:51 +010021namespace ranges {
Nikolas Klauser671b4752022-02-11 17:01:58 +010022 template <class I, class F>
Nikolas Klauser2e263162022-02-21 22:48:36 +010023 struct in_fun_result; // since C++20
Nikolas Klauser671b4752022-02-11 17:01:58 +010024
Nikolas Klauserf74be4e2022-01-14 02:55:51 +010025 template <class I1, class I2>
Nikolas Klauser2e263162022-02-21 22:48:36 +010026 struct in_in_result; // since C++20
Nikolas Klauser05e2cd82022-01-25 11:21:47 +010027
28 template <class I1, class I2, class O>
Nikolas Klauser2e263162022-02-21 22:48:36 +010029 struct in_in_out_result; // since C++20
Nikolas Klauser61ce8162022-02-03 02:17:03 +010030
31 template <class I, class O1, class O2>
32 struct in_out_out_result; // since C++20
Nikolas Klauser671b4752022-02-11 17:01:58 +010033
Nikolas Klauser2e263162022-02-21 22:48:36 +010034 template <class I1, class I2>
35 struct min_max_result; // since C++20
36
Nikolas Klauserdd5ad212022-02-21 23:07:02 +010037 template <class I>
38 struct in_found_result; // since C++20
39
Nikolas Klauser0a62a172022-02-11 13:11:57 +010040 template<forward_iterator I, sentinel_for<I> S, class Proj = identity,
41 indirect_strict_weak_order<projected<I, Proj>> Comp = ranges::less> // since C++20
42 constexpr I min_element(I first, S last, Comp comp = {}, Proj proj = {});
43
44 template<forward_range R, class Proj = identity,
45 indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less> // since C++20
46 constexpr borrowed_iterator_t<R> min_element(R&& r, Comp comp = {}, Proj proj = {});
Nikolas Klauserf74be4e2022-01-14 02:55:51 +010047}
48
Howard Hinnantc51e1022010-05-11 19:42:16 +000049template <class InputIterator, class Predicate>
Marshall Clowd607fdb2018-01-15 17:20:36 +000050 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000051 all_of(InputIterator first, InputIterator last, Predicate pred);
52
53template <class InputIterator, class Predicate>
Marshall Clowd607fdb2018-01-15 17:20:36 +000054 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000055 any_of(InputIterator first, InputIterator last, Predicate pred);
56
57template <class InputIterator, class Predicate>
Marshall Clowd607fdb2018-01-15 17:20:36 +000058 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000059 none_of(InputIterator first, InputIterator last, Predicate pred);
60
61template <class InputIterator, class Function>
Marshall Clow5492c8a2018-01-22 20:44:33 +000062 constexpr Function // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000063 for_each(InputIterator first, InputIterator last, Function f);
64
Marshall Clowde0169c2017-05-25 02:29:54 +000065template<class InputIterator, class Size, class Function>
Marshall Clow5492c8a2018-01-22 20:44:33 +000066 constexpr InputIterator // constexpr in C++20
67 for_each_n(InputIterator first, Size n, Function f); // C++17
Marshall Clowde0169c2017-05-25 02:29:54 +000068
Howard Hinnantc51e1022010-05-11 19:42:16 +000069template <class InputIterator, class T>
Marshall Clowee0161e2018-01-15 19:26:05 +000070 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000071 find(InputIterator first, InputIterator last, const T& value);
72
73template <class InputIterator, class Predicate>
Marshall Clowee0161e2018-01-15 19:26:05 +000074 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000075 find_if(InputIterator first, InputIterator last, Predicate pred);
76
77template<class InputIterator, class Predicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -050078 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000079 find_if_not(InputIterator first, InputIterator last, Predicate pred);
80
81template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -050082 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000083 find_end(ForwardIterator1 first1, ForwardIterator1 last1,
84 ForwardIterator2 first2, ForwardIterator2 last2);
85
86template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -050087 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000088 find_end(ForwardIterator1 first1, ForwardIterator1 last1,
89 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
90
91template <class ForwardIterator1, class ForwardIterator2>
Marshall Clowee0161e2018-01-15 19:26:05 +000092 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000093 find_first_of(ForwardIterator1 first1, ForwardIterator1 last1,
94 ForwardIterator2 first2, ForwardIterator2 last2);
95
96template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clowee0161e2018-01-15 19:26:05 +000097 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000098 find_first_of(ForwardIterator1 first1, ForwardIterator1 last1,
99 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
100
101template <class ForwardIterator>
Marshall Clowee0161e2018-01-15 19:26:05 +0000102 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000103 adjacent_find(ForwardIterator first, ForwardIterator last);
104
105template <class ForwardIterator, class BinaryPredicate>
Marshall Clowee0161e2018-01-15 19:26:05 +0000106 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000107 adjacent_find(ForwardIterator first, ForwardIterator last, BinaryPredicate pred);
108
109template <class InputIterator, class T>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000110 constexpr typename iterator_traits<InputIterator>::difference_type // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000111 count(InputIterator first, InputIterator last, const T& value);
112
113template <class InputIterator, class Predicate>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000114 constexpr typename iterator_traits<InputIterator>::difference_type // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000115 count_if(InputIterator first, InputIterator last, Predicate pred);
116
117template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000118 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000119 mismatch(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2);
120
Marshall Clow96b42b22013-05-09 21:14:23 +0000121template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000122 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Aditya Kumar3a0179a2016-08-25 11:52:38 +0000123 mismatch(InputIterator1 first1, InputIterator1 last1,
Marshall Clow96b42b22013-05-09 21:14:23 +0000124 InputIterator2 first2, InputIterator2 last2); // **C++14**
125
Howard Hinnantc51e1022010-05-11 19:42:16 +0000126template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000127 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000128 mismatch(InputIterator1 first1, InputIterator1 last1,
129 InputIterator2 first2, BinaryPredicate pred);
130
Marshall Clow96b42b22013-05-09 21:14:23 +0000131template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000132 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000133 mismatch(InputIterator1 first1, InputIterator1 last1,
134 InputIterator2 first2, InputIterator2 last2,
135 BinaryPredicate pred); // **C++14**
136
Howard Hinnantc51e1022010-05-11 19:42:16 +0000137template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000138 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000139 equal(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2);
140
Marshall Clow96b42b22013-05-09 21:14:23 +0000141template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000142 constexpr bool // constexpr in C++20
Aditya Kumar3a0179a2016-08-25 11:52:38 +0000143 equal(InputIterator1 first1, InputIterator1 last1,
Marshall Clow96b42b22013-05-09 21:14:23 +0000144 InputIterator2 first2, InputIterator2 last2); // **C++14**
145
Howard Hinnantc51e1022010-05-11 19:42:16 +0000146template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000147 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000148 equal(InputIterator1 first1, InputIterator1 last1,
149 InputIterator2 first2, BinaryPredicate pred);
150
Marshall Clow96b42b22013-05-09 21:14:23 +0000151template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000152 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000153 equal(InputIterator1 first1, InputIterator1 last1,
154 InputIterator2 first2, InputIterator2 last2,
155 BinaryPredicate pred); // **C++14**
156
Howard Hinnantc51e1022010-05-11 19:42:16 +0000157template<class ForwardIterator1, class ForwardIterator2>
Marshall Clow96d050a2018-01-15 16:16:32 +0000158 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000159 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
160 ForwardIterator2 first2);
161
Marshall Clow96b42b22013-05-09 21:14:23 +0000162template<class ForwardIterator1, class ForwardIterator2>
Marshall Clow96d050a2018-01-15 16:16:32 +0000163 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000164 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
165 ForwardIterator2 first2, ForwardIterator2 last2); // **C++14**
166
Howard Hinnantc51e1022010-05-11 19:42:16 +0000167template<class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000168 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000169 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
170 ForwardIterator2 first2, BinaryPredicate pred);
171
Marshall Clow96b42b22013-05-09 21:14:23 +0000172template<class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000173 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000174 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
175 ForwardIterator2 first2, ForwardIterator2 last2,
176 BinaryPredicate pred); // **C++14**
177
Howard Hinnantc51e1022010-05-11 19:42:16 +0000178template <class ForwardIterator1, class ForwardIterator2>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000179 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000180 search(ForwardIterator1 first1, ForwardIterator1 last1,
181 ForwardIterator2 first2, ForwardIterator2 last2);
182
183template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000184 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000185 search(ForwardIterator1 first1, ForwardIterator1 last1,
186 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
187
188template <class ForwardIterator, class Size, class T>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000189 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000190 search_n(ForwardIterator first, ForwardIterator last, Size count, const T& value);
191
192template <class ForwardIterator, class Size, class T, class BinaryPredicate>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000193 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000194 search_n(ForwardIterator first, ForwardIterator last,
195 Size count, const T& value, BinaryPredicate pred);
196
197template <class InputIterator, class OutputIterator>
Louis Dionne65b433b2019-11-06 12:02:41 +0000198 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000199 copy(InputIterator first, InputIterator last, OutputIterator result);
200
201template<class InputIterator, class OutputIterator, class Predicate>
Louis Dionne65b433b2019-11-06 12:02:41 +0000202 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000203 copy_if(InputIterator first, InputIterator last,
204 OutputIterator result, Predicate pred);
205
206template<class InputIterator, class Size, class OutputIterator>
Louis Dionne65b433b2019-11-06 12:02:41 +0000207 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000208 copy_n(InputIterator first, Size n, OutputIterator result);
209
210template <class BidirectionalIterator1, class BidirectionalIterator2>
Louis Dionne65b433b2019-11-06 12:02:41 +0000211 constexpr BidirectionalIterator2 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000212 copy_backward(BidirectionalIterator1 first, BidirectionalIterator1 last,
213 BidirectionalIterator2 result);
214
215template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500216 constexpr ForwardIterator2 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000217 swap_ranges(ForwardIterator1 first1, ForwardIterator1 last1, ForwardIterator2 first2);
218
Nikolas Klauser4ceab5f2022-02-10 13:33:03 +0100219template<input_iterator I1, sentinel_for<I1> S1, input_iterator I2, sentinel_for<I2> S2>
220 requires indirectly_swappable<I1, I2>
221 constexpr ranges::swap_ranges_result<I1, I2>
222 ranges::swap_ranges(I1 first1, S1 last1, I2 first2, S2 last2);
223
224template<input_range R1, input_range R2>
225 requires indirectly_swappable<iterator_t<R1>, iterator_t<R2>>
226 constexpr ranges::swap_ranges_result<borrowed_iterator_t<R1>, borrowed_iterator_t<R2>>
227 ranges::swap_ranges(R1&& r1, R2&& r2);
228
Howard Hinnantc51e1022010-05-11 19:42:16 +0000229template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500230 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000231 iter_swap(ForwardIterator1 a, ForwardIterator2 b);
232
233template <class InputIterator, class OutputIterator, class UnaryOperation>
Marshall Clow31427c62018-01-19 17:45:39 +0000234 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000235 transform(InputIterator first, InputIterator last, OutputIterator result, UnaryOperation op);
236
237template <class InputIterator1, class InputIterator2, class OutputIterator, class BinaryOperation>
Marshall Clow31427c62018-01-19 17:45:39 +0000238 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000239 transform(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2,
240 OutputIterator result, BinaryOperation binary_op);
241
242template <class ForwardIterator, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000243 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000244 replace(ForwardIterator first, ForwardIterator last, const T& old_value, const T& new_value);
245
246template <class ForwardIterator, class Predicate, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000247 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000248 replace_if(ForwardIterator first, ForwardIterator last, Predicate pred, const T& new_value);
249
250template <class InputIterator, class OutputIterator, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000251 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000252 replace_copy(InputIterator first, InputIterator last, OutputIterator result,
253 const T& old_value, const T& new_value);
254
255template <class InputIterator, class OutputIterator, class Predicate, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000256 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000257 replace_copy_if(InputIterator first, InputIterator last, OutputIterator result, Predicate pred, const T& new_value);
258
259template <class ForwardIterator, class T>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000260 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000261 fill(ForwardIterator first, ForwardIterator last, const T& value);
262
263template <class OutputIterator, class Size, class T>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000264 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000265 fill_n(OutputIterator first, Size n, const T& value);
266
267template <class ForwardIterator, class Generator>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000268 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000269 generate(ForwardIterator first, ForwardIterator last, Generator gen);
270
271template <class OutputIterator, class Size, class Generator>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000272 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000273 generate_n(OutputIterator first, Size n, Generator gen);
274
275template <class ForwardIterator, class T>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000276 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000277 remove(ForwardIterator first, ForwardIterator last, const T& value);
278
279template <class ForwardIterator, class Predicate>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000280 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000281 remove_if(ForwardIterator first, ForwardIterator last, Predicate pred);
282
283template <class InputIterator, class OutputIterator, class T>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000284 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000285 remove_copy(InputIterator first, InputIterator last, OutputIterator result, const T& value);
286
287template <class InputIterator, class OutputIterator, class Predicate>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000288 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000289 remove_copy_if(InputIterator first, InputIterator last, OutputIterator result, Predicate pred);
290
291template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500292 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000293 unique(ForwardIterator first, ForwardIterator last);
294
295template <class ForwardIterator, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500296 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000297 unique(ForwardIterator first, ForwardIterator last, BinaryPredicate pred);
298
299template <class InputIterator, class OutputIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500300 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000301 unique_copy(InputIterator first, InputIterator last, OutputIterator result);
302
303template <class InputIterator, class OutputIterator, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500304 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000305 unique_copy(InputIterator first, InputIterator last, OutputIterator result, BinaryPredicate pred);
306
307template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500308 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000309 reverse(BidirectionalIterator first, BidirectionalIterator last);
310
311template <class BidirectionalIterator, class OutputIterator>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000312 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000313 reverse_copy(BidirectionalIterator first, BidirectionalIterator last, OutputIterator result);
314
315template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500316 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000317 rotate(ForwardIterator first, ForwardIterator middle, ForwardIterator last);
318
319template <class ForwardIterator, class OutputIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500320 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000321 rotate_copy(ForwardIterator first, ForwardIterator middle, ForwardIterator last, OutputIterator result);
322
323template <class RandomAccessIterator>
324 void
Marshall Clowfac06e52017-03-23 13:43:37 +0000325 random_shuffle(RandomAccessIterator first, RandomAccessIterator last); // deprecated in C++14, removed in C++17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000326
327template <class RandomAccessIterator, class RandomNumberGenerator>
328 void
Marshall Clow83f35392014-03-03 06:14:19 +0000329 random_shuffle(RandomAccessIterator first, RandomAccessIterator last,
Marshall Clowfac06e52017-03-23 13:43:37 +0000330 RandomNumberGenerator& rand); // deprecated in C++14, removed in C++17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000331
Eric Fiselier1208fcd2016-08-28 22:14:37 +0000332template<class PopulationIterator, class SampleIterator,
333 class Distance, class UniformRandomBitGenerator>
334 SampleIterator sample(PopulationIterator first, PopulationIterator last,
335 SampleIterator out, Distance n,
336 UniformRandomBitGenerator&& g); // C++17
337
Howard Hinnant578ac0f2010-05-26 17:49:34 +0000338template<class RandomAccessIterator, class UniformRandomNumberGenerator>
339 void shuffle(RandomAccessIterator first, RandomAccessIterator last,
Howard Hinnanta5e71782010-11-18 01:47:02 +0000340 UniformRandomNumberGenerator&& g);
Howard Hinnant578ac0f2010-05-26 17:49:34 +0000341
Arthur O'Dwyercea050d2020-12-26 01:39:03 -0500342template<class ForwardIterator>
343 constexpr ForwardIterator
344 shift_left(ForwardIterator first, ForwardIterator last,
345 typename iterator_traits<ForwardIterator>::difference_type n); // C++20
346
347template<class ForwardIterator>
348 constexpr ForwardIterator
349 shift_right(ForwardIterator first, ForwardIterator last,
350 typename iterator_traits<ForwardIterator>::difference_type n); // C++20
351
Howard Hinnantc51e1022010-05-11 19:42:16 +0000352template <class InputIterator, class Predicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000353 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000354 is_partitioned(InputIterator first, InputIterator last, Predicate pred);
355
356template <class ForwardIterator, class Predicate>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500357 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000358 partition(ForwardIterator first, ForwardIterator last, Predicate pred);
359
360template <class InputIterator, class OutputIterator1,
361 class OutputIterator2, class Predicate>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000362 constexpr pair<OutputIterator1, OutputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000363 partition_copy(InputIterator first, InputIterator last,
364 OutputIterator1 out_true, OutputIterator2 out_false,
365 Predicate pred);
366
367template <class ForwardIterator, class Predicate>
368 ForwardIterator
369 stable_partition(ForwardIterator first, ForwardIterator last, Predicate pred);
370
371template<class ForwardIterator, class Predicate>
Marshall Clowe00916c2018-01-16 02:34:41 +0000372 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000373 partition_point(ForwardIterator first, ForwardIterator last, Predicate pred);
374
375template <class ForwardIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +0000376 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000377 is_sorted(ForwardIterator first, ForwardIterator last);
378
379template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500380 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000381 is_sorted(ForwardIterator first, ForwardIterator last, Compare comp);
382
383template<class ForwardIterator>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000384 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000385 is_sorted_until(ForwardIterator first, ForwardIterator last);
386
387template <class ForwardIterator, class Compare>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000388 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000389 is_sorted_until(ForwardIterator first, ForwardIterator last, Compare comp);
390
391template <class RandomAccessIterator>
Arthur O'Dwyer1bb0f672020-12-20 15:21:42 -0500392 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000393 sort(RandomAccessIterator first, RandomAccessIterator last);
394
395template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer1bb0f672020-12-20 15:21:42 -0500396 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000397 sort(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
398
399template <class RandomAccessIterator>
400 void
401 stable_sort(RandomAccessIterator first, RandomAccessIterator last);
402
403template <class RandomAccessIterator, class Compare>
404 void
405 stable_sort(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
406
407template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500408 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000409 partial_sort(RandomAccessIterator first, RandomAccessIterator middle, RandomAccessIterator last);
410
411template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500412 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000413 partial_sort(RandomAccessIterator first, RandomAccessIterator middle, RandomAccessIterator last, Compare comp);
414
415template <class InputIterator, class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500416 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000417 partial_sort_copy(InputIterator first, InputIterator last,
418 RandomAccessIterator result_first, RandomAccessIterator result_last);
419
420template <class InputIterator, class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500421 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000422 partial_sort_copy(InputIterator first, InputIterator last,
423 RandomAccessIterator result_first, RandomAccessIterator result_last, Compare comp);
424
425template <class RandomAccessIterator>
Arthur O'Dwyer4f5717b2021-02-04 18:12:52 -0500426 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000427 nth_element(RandomAccessIterator first, RandomAccessIterator nth, RandomAccessIterator last);
428
429template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer4f5717b2021-02-04 18:12:52 -0500430 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000431 nth_element(RandomAccessIterator first, RandomAccessIterator nth, RandomAccessIterator last, Compare comp);
432
433template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000434 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000435 lower_bound(ForwardIterator first, ForwardIterator last, const T& value);
436
437template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000438 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000439 lower_bound(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
440
441template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000442 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000443 upper_bound(ForwardIterator first, ForwardIterator last, const T& value);
444
445template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000446 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000447 upper_bound(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
448
449template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000450 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000451 equal_range(ForwardIterator first, ForwardIterator last, const T& value);
452
453template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000454 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000455 equal_range(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
456
457template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000458 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000459 binary_search(ForwardIterator first, ForwardIterator last, const T& value);
460
461template <class ForwardIterator, class T, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000462 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000463 binary_search(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
464
465template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500466 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000467 merge(InputIterator1 first1, InputIterator1 last1,
468 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
469
470template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500471 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000472 merge(InputIterator1 first1, InputIterator1 last1,
473 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
474
475template <class BidirectionalIterator>
476 void
477 inplace_merge(BidirectionalIterator first, BidirectionalIterator middle, BidirectionalIterator last);
478
479template <class BidirectionalIterator, class Compare>
480 void
481 inplace_merge(BidirectionalIterator first, BidirectionalIterator middle, BidirectionalIterator last, Compare comp);
482
483template <class InputIterator1, class InputIterator2>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000484 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000485 includes(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2);
486
487template <class InputIterator1, class InputIterator2, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000488 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000489 includes(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2, Compare comp);
490
491template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500492 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000493 set_union(InputIterator1 first1, InputIterator1 last1,
494 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
495
496template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500497 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000498 set_union(InputIterator1 first1, InputIterator1 last1,
499 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
500
501template <class InputIterator1, class InputIterator2, class OutputIterator>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000502 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000503 set_intersection(InputIterator1 first1, InputIterator1 last1,
504 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
505
506template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000507 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000508 set_intersection(InputIterator1 first1, InputIterator1 last1,
509 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
510
511template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500512 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000513 set_difference(InputIterator1 first1, InputIterator1 last1,
514 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
515
516template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500517 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000518 set_difference(InputIterator1 first1, InputIterator1 last1,
519 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
520
521template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500522 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000523 set_symmetric_difference(InputIterator1 first1, InputIterator1 last1,
524 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
525
526template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500527 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000528 set_symmetric_difference(InputIterator1 first1, InputIterator1 last1,
529 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
530
531template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500532 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000533 push_heap(RandomAccessIterator first, RandomAccessIterator last);
534
535template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500536 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000537 push_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
538
539template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500540 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000541 pop_heap(RandomAccessIterator first, RandomAccessIterator last);
542
543template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500544 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000545 pop_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
546
547template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500548 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000549 make_heap(RandomAccessIterator first, RandomAccessIterator last);
550
551template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500552 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000553 make_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
554
555template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500556 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000557 sort_heap(RandomAccessIterator first, RandomAccessIterator last);
558
559template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500560 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000561 sort_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
562
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000563template <class RandomAccessIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +0000564 constexpr bool // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000565 is_heap(RandomAccessIterator first, RandomAccessiterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000566
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000567template <class RandomAccessIterator, class Compare>
Marshall Clow96d050a2018-01-15 16:16:32 +0000568 constexpr bool // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000569 is_heap(RandomAccessIterator first, RandomAccessiterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000570
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000571template <class RandomAccessIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +0000572 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000573 is_heap_until(RandomAccessIterator first, RandomAccessiterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000574
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000575template <class RandomAccessIterator, class Compare>
Marshall Clow96d050a2018-01-15 16:16:32 +0000576 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000577 is_heap_until(RandomAccessIterator first, RandomAccessiterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000578
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000579template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500580 constexpr ForwardIterator // constexpr in C++14
581 min_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000582
583template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500584 constexpr ForwardIterator // constexpr in C++14
585 min_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000586
Howard Hinnantc51e1022010-05-11 19:42:16 +0000587template <class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500588 constexpr const T& // constexpr in C++14
589 min(const T& a, const T& b);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000590
591template <class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500592 constexpr const T& // constexpr in C++14
593 min(const T& a, const T& b, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000594
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000595template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500596 constexpr T // constexpr in C++14
597 min(initializer_list<T> t);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000598
599template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500600 constexpr T // constexpr in C++14
601 min(initializer_list<T> t, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000602
Marshall Clow3e18d0e2016-03-07 22:43:49 +0000603template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500604 constexpr const T& clamp(const T& v, const T& lo, const T& hi); // C++17
Marshall Clow3e18d0e2016-03-07 22:43:49 +0000605
606template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500607 constexpr const T& clamp(const T& v, const T& lo, const T& hi, Compare comp); // C++17
Marshall Clow3e18d0e2016-03-07 22:43:49 +0000608
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000609template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500610 constexpr ForwardIterator // constexpr in C++14
611 max_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000612
613template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500614 constexpr ForwardIterator // constexpr in C++14
615 max_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000616
Howard Hinnantc51e1022010-05-11 19:42:16 +0000617template <class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500618 constexpr const T& // constexpr in C++14
619 max(const T& a, const T& b);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000620
621template <class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500622 constexpr const T& // constexpr in C++14
623 max(const T& a, const T& b, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000624
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000625template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500626 constexpr T // constexpr in C++14
627 max(initializer_list<T> t);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000628
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000629template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500630 constexpr T // constexpr in C++14
631 max(initializer_list<T> t, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000632
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000633template<class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500634 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++14
635 minmax_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000636
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000637template<class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500638 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++14
639 minmax_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000640
641template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500642 constexpr pair<const T&, const T&> // constexpr in C++14
643 minmax(const T& a, const T& b);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000644
645template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500646 constexpr pair<const T&, const T&> // constexpr in C++14
647 minmax(const T& a, const T& b, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000648
649template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500650 constexpr pair<T, T> // constexpr in C++14
651 minmax(initializer_list<T> t);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000652
653template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500654 constexpr pair<T, T> // constexpr in C++14
655 minmax(initializer_list<T> t, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000656
657template <class InputIterator1, class InputIterator2>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000658 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000659 lexicographical_compare(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2);
660
661template <class InputIterator1, class InputIterator2, class Compare>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000662 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000663 lexicographical_compare(InputIterator1 first1, InputIterator1 last1,
664 InputIterator2 first2, InputIterator2 last2, Compare comp);
665
666template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500667 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000668 next_permutation(BidirectionalIterator first, BidirectionalIterator last);
669
670template <class BidirectionalIterator, class Compare>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500671 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000672 next_permutation(BidirectionalIterator first, BidirectionalIterator last, Compare comp);
673
674template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500675 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000676 prev_permutation(BidirectionalIterator first, BidirectionalIterator last);
677
678template <class BidirectionalIterator, class Compare>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500679 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000680 prev_permutation(BidirectionalIterator first, BidirectionalIterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000681} // std
682
683*/
684
Arthur O'Dwyer3693d7a2022-02-04 13:09:30 -0500685#include <__bits>
Howard Hinnantc51e1022010-05-11 19:42:16 +0000686#include <__config>
Louis Dionnea60dd872021-06-17 11:30:11 -0400687#include <__debug>
Howard Hinnant60e5cf42012-07-26 17:09:09 +0000688#include <cstddef>
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400689#include <cstring>
690#include <functional>
691#include <initializer_list>
692#include <iterator>
693#include <memory>
694#include <type_traits>
Marshall Clow0a1e7502018-09-12 19:41:40 +0000695#include <version>
Howard Hinnantea382952013-08-14 18:00:20 +0000696
Nikolas Klauser8fccd622022-03-05 19:17:07 +0100697#include <utility> // TODO: Remove this
698
Louis Dionnea60dd872021-06-17 11:30:11 -0400699#include <__algorithm/adjacent_find.h>
700#include <__algorithm/all_of.h>
701#include <__algorithm/any_of.h>
702#include <__algorithm/binary_search.h>
703#include <__algorithm/clamp.h>
704#include <__algorithm/comp.h>
705#include <__algorithm/comp_ref_type.h>
706#include <__algorithm/copy.h>
707#include <__algorithm/copy_backward.h>
708#include <__algorithm/copy_if.h>
709#include <__algorithm/copy_n.h>
710#include <__algorithm/count.h>
711#include <__algorithm/count_if.h>
712#include <__algorithm/equal.h>
713#include <__algorithm/equal_range.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400714#include <__algorithm/fill.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -0500715#include <__algorithm/fill_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400716#include <__algorithm/find.h>
717#include <__algorithm/find_end.h>
718#include <__algorithm/find_first_of.h>
719#include <__algorithm/find_if.h>
720#include <__algorithm/find_if_not.h>
721#include <__algorithm/for_each.h>
722#include <__algorithm/for_each_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400723#include <__algorithm/generate.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -0500724#include <__algorithm/generate_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400725#include <__algorithm/half_positive.h>
Nikolas Klauserdd5ad212022-02-21 23:07:02 +0100726#include <__algorithm/in_found_result.h>
Nikolas Klauser671b4752022-02-11 17:01:58 +0100727#include <__algorithm/in_fun_result.h>
Nikolas Klauser05e2cd82022-01-25 11:21:47 +0100728#include <__algorithm/in_in_out_result.h>
Nikolas Klauserf74be4e2022-01-14 02:55:51 +0100729#include <__algorithm/in_in_result.h>
Nikolas Klauser61ce8162022-02-03 02:17:03 +0100730#include <__algorithm/in_out_out_result.h>
Konstantin Varlamov74736812022-01-10 22:49:37 -0800731#include <__algorithm/in_out_result.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400732#include <__algorithm/includes.h>
733#include <__algorithm/inplace_merge.h>
734#include <__algorithm/is_heap.h>
735#include <__algorithm/is_heap_until.h>
736#include <__algorithm/is_partitioned.h>
737#include <__algorithm/is_permutation.h>
738#include <__algorithm/is_sorted.h>
739#include <__algorithm/is_sorted_until.h>
Christopher Di Bella41f26e82021-06-05 02:47:47 +0000740#include <__algorithm/iter_swap.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400741#include <__algorithm/lexicographical_compare.h>
742#include <__algorithm/lower_bound.h>
743#include <__algorithm/make_heap.h>
744#include <__algorithm/max.h>
745#include <__algorithm/max_element.h>
746#include <__algorithm/merge.h>
747#include <__algorithm/min.h>
748#include <__algorithm/min_element.h>
Nikolas Klauser2e263162022-02-21 22:48:36 +0100749#include <__algorithm/min_max_result.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400750#include <__algorithm/minmax.h>
751#include <__algorithm/minmax_element.h>
752#include <__algorithm/mismatch.h>
753#include <__algorithm/move.h>
754#include <__algorithm/move_backward.h>
755#include <__algorithm/next_permutation.h>
756#include <__algorithm/none_of.h>
757#include <__algorithm/nth_element.h>
758#include <__algorithm/partial_sort.h>
759#include <__algorithm/partial_sort_copy.h>
760#include <__algorithm/partition.h>
761#include <__algorithm/partition_copy.h>
762#include <__algorithm/partition_point.h>
763#include <__algorithm/pop_heap.h>
764#include <__algorithm/prev_permutation.h>
765#include <__algorithm/push_heap.h>
Nikolas Klauser0a62a172022-02-11 13:11:57 +0100766#include <__algorithm/ranges_min_element.h>
Nikolas Klauser4ceab5f2022-02-10 13:33:03 +0100767#include <__algorithm/ranges_swap_ranges.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400768#include <__algorithm/remove.h>
769#include <__algorithm/remove_copy.h>
770#include <__algorithm/remove_copy_if.h>
771#include <__algorithm/remove_if.h>
772#include <__algorithm/replace.h>
773#include <__algorithm/replace_copy.h>
774#include <__algorithm/replace_copy_if.h>
775#include <__algorithm/replace_if.h>
776#include <__algorithm/reverse.h>
777#include <__algorithm/reverse_copy.h>
778#include <__algorithm/rotate.h>
779#include <__algorithm/rotate_copy.h>
780#include <__algorithm/sample.h>
781#include <__algorithm/search.h>
782#include <__algorithm/search_n.h>
783#include <__algorithm/set_difference.h>
784#include <__algorithm/set_intersection.h>
785#include <__algorithm/set_symmetric_difference.h>
786#include <__algorithm/set_union.h>
787#include <__algorithm/shift_left.h>
788#include <__algorithm/shift_right.h>
789#include <__algorithm/shuffle.h>
790#include <__algorithm/sift_down.h>
791#include <__algorithm/sort.h>
792#include <__algorithm/sort_heap.h>
793#include <__algorithm/stable_partition.h>
794#include <__algorithm/stable_sort.h>
Christopher Di Bella41f26e82021-06-05 02:47:47 +0000795#include <__algorithm/swap_ranges.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400796#include <__algorithm/transform.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400797#include <__algorithm/unique.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -0500798#include <__algorithm/unique_copy.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400799#include <__algorithm/unwrap_iter.h>
800#include <__algorithm/upper_bound.h>
Eric Fiselier14b6de92014-08-10 23:53:08 +0000801
Howard Hinnantaaaa52b2011-10-17 20:05:10 +0000802#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
Arthur O'Dwyer6eeaa002022-02-01 20:16:40 -0500803# pragma GCC system_header
Howard Hinnantaaaa52b2011-10-17 20:05:10 +0000804#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +0000805
Louis Dionne59d0b3c2019-08-05 18:29:14 +0000806#if defined(_LIBCPP_HAS_PARALLEL_ALGORITHMS) && _LIBCPP_STD_VER >= 17
Louis Dionned53d8c02019-08-06 21:11:24 +0000807# include <__pstl_algorithm>
Louis Dionne59d0b3c2019-08-05 18:29:14 +0000808#endif
809
Louis Dionne2b1ceaa2021-04-20 12:03:32 -0400810#endif // _LIBCPP_ALGORITHM