blob: b35ad674cbe779709530a52104313e08bb179b16 [file] [log] [blame]
Howard Hinnantc51e1022010-05-11 19:42:16 +00001// -*- C++ -*-
Louis Dionne9bd93882021-11-17 16:25:01 -05002//===----------------------------------------------------------------------===//
Howard Hinnantc51e1022010-05-11 19:42:16 +00003//
Chandler Carruthd2012102019-01-19 10:56:40 +00004// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
5// See https://llvm.org/LICENSE.txt for license information.
6// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
Howard Hinnantc51e1022010-05-11 19:42:16 +00007//
8//===----------------------------------------------------------------------===//
9
10#ifndef _LIBCPP_ALGORITHM
11#define _LIBCPP_ALGORITHM
12
13/*
14 algorithm synopsis
15
16#include <initializer_list>
17
18namespace std
19{
20
Nikolas Klauserf74be4e2022-01-14 02:55:51 +010021namespace ranges {
Nikolas Klauser671b4752022-02-11 17:01:58 +010022 template <class I, class F>
23 struct in_fun_result; // since C++20
24
Nikolas Klauserf74be4e2022-01-14 02:55:51 +010025 template <class I1, class I2>
Nikolas Klauser05e2cd82022-01-25 11:21:47 +010026 struct in_in_result; // since C++20
27
28 template <class I1, class I2, class O>
29 struct in_in_out_result; // since C++20
Nikolas Klauser61ce8162022-02-03 02:17:03 +010030
31 template <class I, class O1, class O2>
32 struct in_out_out_result; // since C++20
Nikolas Klauser671b4752022-02-11 17:01:58 +010033
Nikolas Klauser0a62a172022-02-11 13:11:57 +010034 template<forward_iterator I, sentinel_for<I> S, class Proj = identity,
35 indirect_strict_weak_order<projected<I, Proj>> Comp = ranges::less> // since C++20
36 constexpr I min_element(I first, S last, Comp comp = {}, Proj proj = {});
37
38 template<forward_range R, class Proj = identity,
39 indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less> // since C++20
40 constexpr borrowed_iterator_t<R> min_element(R&& r, Comp comp = {}, Proj proj = {});
Nikolas Klauserf74be4e2022-01-14 02:55:51 +010041}
42
Howard Hinnantc51e1022010-05-11 19:42:16 +000043template <class InputIterator, class Predicate>
Marshall Clowd607fdb2018-01-15 17:20:36 +000044 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000045 all_of(InputIterator first, InputIterator last, Predicate pred);
46
47template <class InputIterator, class Predicate>
Marshall Clowd607fdb2018-01-15 17:20:36 +000048 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000049 any_of(InputIterator first, InputIterator last, Predicate pred);
50
51template <class InputIterator, class Predicate>
Marshall Clowd607fdb2018-01-15 17:20:36 +000052 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000053 none_of(InputIterator first, InputIterator last, Predicate pred);
54
55template <class InputIterator, class Function>
Marshall Clow5492c8a2018-01-22 20:44:33 +000056 constexpr Function // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000057 for_each(InputIterator first, InputIterator last, Function f);
58
Marshall Clowde0169c2017-05-25 02:29:54 +000059template<class InputIterator, class Size, class Function>
Marshall Clow5492c8a2018-01-22 20:44:33 +000060 constexpr InputIterator // constexpr in C++20
61 for_each_n(InputIterator first, Size n, Function f); // C++17
Marshall Clowde0169c2017-05-25 02:29:54 +000062
Howard Hinnantc51e1022010-05-11 19:42:16 +000063template <class InputIterator, class T>
Marshall Clowee0161e2018-01-15 19:26:05 +000064 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000065 find(InputIterator first, InputIterator last, const T& value);
66
67template <class InputIterator, class Predicate>
Marshall Clowee0161e2018-01-15 19:26:05 +000068 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000069 find_if(InputIterator first, InputIterator last, Predicate pred);
70
71template<class InputIterator, class Predicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -050072 constexpr InputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000073 find_if_not(InputIterator first, InputIterator last, Predicate pred);
74
75template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -050076 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000077 find_end(ForwardIterator1 first1, ForwardIterator1 last1,
78 ForwardIterator2 first2, ForwardIterator2 last2);
79
80template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -050081 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000082 find_end(ForwardIterator1 first1, ForwardIterator1 last1,
83 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
84
85template <class ForwardIterator1, class ForwardIterator2>
Marshall Clowee0161e2018-01-15 19:26:05 +000086 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000087 find_first_of(ForwardIterator1 first1, ForwardIterator1 last1,
88 ForwardIterator2 first2, ForwardIterator2 last2);
89
90template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clowee0161e2018-01-15 19:26:05 +000091 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000092 find_first_of(ForwardIterator1 first1, ForwardIterator1 last1,
93 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
94
95template <class ForwardIterator>
Marshall Clowee0161e2018-01-15 19:26:05 +000096 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +000097 adjacent_find(ForwardIterator first, ForwardIterator last);
98
99template <class ForwardIterator, class BinaryPredicate>
Marshall Clowee0161e2018-01-15 19:26:05 +0000100 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000101 adjacent_find(ForwardIterator first, ForwardIterator last, BinaryPredicate pred);
102
103template <class InputIterator, class T>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000104 constexpr typename iterator_traits<InputIterator>::difference_type // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000105 count(InputIterator first, InputIterator last, const T& value);
106
107template <class InputIterator, class Predicate>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000108 constexpr typename iterator_traits<InputIterator>::difference_type // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000109 count_if(InputIterator first, InputIterator last, Predicate pred);
110
111template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000112 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000113 mismatch(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2);
114
Marshall Clow96b42b22013-05-09 21:14:23 +0000115template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000116 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Aditya Kumar3a0179a2016-08-25 11:52:38 +0000117 mismatch(InputIterator1 first1, InputIterator1 last1,
Marshall Clow96b42b22013-05-09 21:14:23 +0000118 InputIterator2 first2, InputIterator2 last2); // **C++14**
119
Howard Hinnantc51e1022010-05-11 19:42:16 +0000120template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000121 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000122 mismatch(InputIterator1 first1, InputIterator1 last1,
123 InputIterator2 first2, BinaryPredicate pred);
124
Marshall Clow96b42b22013-05-09 21:14:23 +0000125template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000126 constexpr pair<InputIterator1, InputIterator2> // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000127 mismatch(InputIterator1 first1, InputIterator1 last1,
128 InputIterator2 first2, InputIterator2 last2,
129 BinaryPredicate pred); // **C++14**
130
Howard Hinnantc51e1022010-05-11 19:42:16 +0000131template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000132 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000133 equal(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2);
134
Marshall Clow96b42b22013-05-09 21:14:23 +0000135template <class InputIterator1, class InputIterator2>
Marshall Clow30bf3022018-01-16 02:04:10 +0000136 constexpr bool // constexpr in C++20
Aditya Kumar3a0179a2016-08-25 11:52:38 +0000137 equal(InputIterator1 first1, InputIterator1 last1,
Marshall Clow96b42b22013-05-09 21:14:23 +0000138 InputIterator2 first2, InputIterator2 last2); // **C++14**
139
Howard Hinnantc51e1022010-05-11 19:42:16 +0000140template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000141 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000142 equal(InputIterator1 first1, InputIterator1 last1,
143 InputIterator2 first2, BinaryPredicate pred);
144
Marshall Clow96b42b22013-05-09 21:14:23 +0000145template <class InputIterator1, class InputIterator2, class BinaryPredicate>
Marshall Clow30bf3022018-01-16 02:04:10 +0000146 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000147 equal(InputIterator1 first1, InputIterator1 last1,
148 InputIterator2 first2, InputIterator2 last2,
149 BinaryPredicate pred); // **C++14**
150
Howard Hinnantc51e1022010-05-11 19:42:16 +0000151template<class ForwardIterator1, class ForwardIterator2>
Marshall Clow96d050a2018-01-15 16:16:32 +0000152 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000153 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
154 ForwardIterator2 first2);
155
Marshall Clow96b42b22013-05-09 21:14:23 +0000156template<class ForwardIterator1, class ForwardIterator2>
Marshall Clow96d050a2018-01-15 16:16:32 +0000157 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000158 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
159 ForwardIterator2 first2, ForwardIterator2 last2); // **C++14**
160
Howard Hinnantc51e1022010-05-11 19:42:16 +0000161template<class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000162 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000163 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
164 ForwardIterator2 first2, BinaryPredicate pred);
165
Marshall Clow96b42b22013-05-09 21:14:23 +0000166template<class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000167 constexpr bool // constexpr in C++20
Marshall Clow96b42b22013-05-09 21:14:23 +0000168 is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
169 ForwardIterator2 first2, ForwardIterator2 last2,
170 BinaryPredicate pred); // **C++14**
171
Howard Hinnantc51e1022010-05-11 19:42:16 +0000172template <class ForwardIterator1, class ForwardIterator2>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000173 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000174 search(ForwardIterator1 first1, ForwardIterator1 last1,
175 ForwardIterator2 first2, ForwardIterator2 last2);
176
177template <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000178 constexpr ForwardIterator1 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000179 search(ForwardIterator1 first1, ForwardIterator1 last1,
180 ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
181
182template <class ForwardIterator, class Size, class T>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000183 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000184 search_n(ForwardIterator first, ForwardIterator last, Size count, const T& value);
185
186template <class ForwardIterator, class Size, class T, class BinaryPredicate>
Marshall Clow323fc5b2018-01-16 15:48:27 +0000187 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000188 search_n(ForwardIterator first, ForwardIterator last,
189 Size count, const T& value, BinaryPredicate pred);
190
191template <class InputIterator, class OutputIterator>
Louis Dionne65b433b2019-11-06 12:02:41 +0000192 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000193 copy(InputIterator first, InputIterator last, OutputIterator result);
194
195template<class InputIterator, class OutputIterator, class Predicate>
Louis Dionne65b433b2019-11-06 12:02:41 +0000196 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000197 copy_if(InputIterator first, InputIterator last,
198 OutputIterator result, Predicate pred);
199
200template<class InputIterator, class Size, class OutputIterator>
Louis Dionne65b433b2019-11-06 12:02:41 +0000201 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000202 copy_n(InputIterator first, Size n, OutputIterator result);
203
204template <class BidirectionalIterator1, class BidirectionalIterator2>
Louis Dionne65b433b2019-11-06 12:02:41 +0000205 constexpr BidirectionalIterator2 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000206 copy_backward(BidirectionalIterator1 first, BidirectionalIterator1 last,
207 BidirectionalIterator2 result);
208
209template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500210 constexpr ForwardIterator2 // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000211 swap_ranges(ForwardIterator1 first1, ForwardIterator1 last1, ForwardIterator2 first2);
212
Nikolas Klauser4ceab5f2022-02-10 13:33:03 +0100213template<input_iterator I1, sentinel_for<I1> S1, input_iterator I2, sentinel_for<I2> S2>
214 requires indirectly_swappable<I1, I2>
215 constexpr ranges::swap_ranges_result<I1, I2>
216 ranges::swap_ranges(I1 first1, S1 last1, I2 first2, S2 last2);
217
218template<input_range R1, input_range R2>
219 requires indirectly_swappable<iterator_t<R1>, iterator_t<R2>>
220 constexpr ranges::swap_ranges_result<borrowed_iterator_t<R1>, borrowed_iterator_t<R2>>
221 ranges::swap_ranges(R1&& r1, R2&& r2);
222
Howard Hinnantc51e1022010-05-11 19:42:16 +0000223template <class ForwardIterator1, class ForwardIterator2>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500224 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000225 iter_swap(ForwardIterator1 a, ForwardIterator2 b);
226
227template <class InputIterator, class OutputIterator, class UnaryOperation>
Marshall Clow31427c62018-01-19 17:45:39 +0000228 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000229 transform(InputIterator first, InputIterator last, OutputIterator result, UnaryOperation op);
230
231template <class InputIterator1, class InputIterator2, class OutputIterator, class BinaryOperation>
Marshall Clow31427c62018-01-19 17:45:39 +0000232 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000233 transform(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2,
234 OutputIterator result, BinaryOperation binary_op);
235
236template <class ForwardIterator, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000237 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000238 replace(ForwardIterator first, ForwardIterator last, const T& old_value, const T& new_value);
239
240template <class ForwardIterator, class Predicate, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000241 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000242 replace_if(ForwardIterator first, ForwardIterator last, Predicate pred, const T& new_value);
243
244template <class InputIterator, class OutputIterator, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000245 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000246 replace_copy(InputIterator first, InputIterator last, OutputIterator result,
247 const T& old_value, const T& new_value);
248
249template <class InputIterator, class OutputIterator, class Predicate, class T>
Marshall Clow01bbbd22018-01-19 18:07:29 +0000250 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000251 replace_copy_if(InputIterator first, InputIterator last, OutputIterator result, Predicate pred, const T& new_value);
252
253template <class ForwardIterator, class T>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000254 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000255 fill(ForwardIterator first, ForwardIterator last, const T& value);
256
257template <class OutputIterator, class Size, class T>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000258 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000259 fill_n(OutputIterator first, Size n, const T& value);
260
261template <class ForwardIterator, class Generator>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000262 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000263 generate(ForwardIterator first, ForwardIterator last, Generator gen);
264
265template <class OutputIterator, class Size, class Generator>
Marshall Clowe9cdc5c2018-01-20 20:14:32 +0000266 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000267 generate_n(OutputIterator first, Size n, Generator gen);
268
269template <class ForwardIterator, class T>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000270 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000271 remove(ForwardIterator first, ForwardIterator last, const T& value);
272
273template <class ForwardIterator, class Predicate>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000274 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000275 remove_if(ForwardIterator first, ForwardIterator last, Predicate pred);
276
277template <class InputIterator, class OutputIterator, class T>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000278 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000279 remove_copy(InputIterator first, InputIterator last, OutputIterator result, const T& value);
280
281template <class InputIterator, class OutputIterator, class Predicate>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000282 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000283 remove_copy_if(InputIterator first, InputIterator last, OutputIterator result, Predicate pred);
284
285template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500286 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000287 unique(ForwardIterator first, ForwardIterator last);
288
289template <class ForwardIterator, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500290 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000291 unique(ForwardIterator first, ForwardIterator last, BinaryPredicate pred);
292
293template <class InputIterator, class OutputIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500294 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000295 unique_copy(InputIterator first, InputIterator last, OutputIterator result);
296
297template <class InputIterator, class OutputIterator, class BinaryPredicate>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500298 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000299 unique_copy(InputIterator first, InputIterator last, OutputIterator result, BinaryPredicate pred);
300
301template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500302 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000303 reverse(BidirectionalIterator first, BidirectionalIterator last);
304
305template <class BidirectionalIterator, class OutputIterator>
Marshall Clow7c0fbd82018-01-22 21:43:04 +0000306 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000307 reverse_copy(BidirectionalIterator first, BidirectionalIterator last, OutputIterator result);
308
309template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500310 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000311 rotate(ForwardIterator first, ForwardIterator middle, ForwardIterator last);
312
313template <class ForwardIterator, class OutputIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500314 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000315 rotate_copy(ForwardIterator first, ForwardIterator middle, ForwardIterator last, OutputIterator result);
316
317template <class RandomAccessIterator>
318 void
Marshall Clowfac06e52017-03-23 13:43:37 +0000319 random_shuffle(RandomAccessIterator first, RandomAccessIterator last); // deprecated in C++14, removed in C++17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000320
321template <class RandomAccessIterator, class RandomNumberGenerator>
322 void
Marshall Clow83f35392014-03-03 06:14:19 +0000323 random_shuffle(RandomAccessIterator first, RandomAccessIterator last,
Marshall Clowfac06e52017-03-23 13:43:37 +0000324 RandomNumberGenerator& rand); // deprecated in C++14, removed in C++17
Howard Hinnantc51e1022010-05-11 19:42:16 +0000325
Eric Fiselier1208fcd2016-08-28 22:14:37 +0000326template<class PopulationIterator, class SampleIterator,
327 class Distance, class UniformRandomBitGenerator>
328 SampleIterator sample(PopulationIterator first, PopulationIterator last,
329 SampleIterator out, Distance n,
330 UniformRandomBitGenerator&& g); // C++17
331
Howard Hinnant578ac0f2010-05-26 17:49:34 +0000332template<class RandomAccessIterator, class UniformRandomNumberGenerator>
333 void shuffle(RandomAccessIterator first, RandomAccessIterator last,
Howard Hinnanta5e71782010-11-18 01:47:02 +0000334 UniformRandomNumberGenerator&& g);
Howard Hinnant578ac0f2010-05-26 17:49:34 +0000335
Arthur O'Dwyercea050d2020-12-26 01:39:03 -0500336template<class ForwardIterator>
337 constexpr ForwardIterator
338 shift_left(ForwardIterator first, ForwardIterator last,
339 typename iterator_traits<ForwardIterator>::difference_type n); // C++20
340
341template<class ForwardIterator>
342 constexpr ForwardIterator
343 shift_right(ForwardIterator first, ForwardIterator last,
344 typename iterator_traits<ForwardIterator>::difference_type n); // C++20
345
Howard Hinnantc51e1022010-05-11 19:42:16 +0000346template <class InputIterator, class Predicate>
Marshall Clow96d050a2018-01-15 16:16:32 +0000347 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000348 is_partitioned(InputIterator first, InputIterator last, Predicate pred);
349
350template <class ForwardIterator, class Predicate>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500351 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000352 partition(ForwardIterator first, ForwardIterator last, Predicate pred);
353
354template <class InputIterator, class OutputIterator1,
355 class OutputIterator2, class Predicate>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000356 constexpr pair<OutputIterator1, OutputIterator2> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000357 partition_copy(InputIterator first, InputIterator last,
358 OutputIterator1 out_true, OutputIterator2 out_false,
359 Predicate pred);
360
361template <class ForwardIterator, class Predicate>
362 ForwardIterator
363 stable_partition(ForwardIterator first, ForwardIterator last, Predicate pred);
364
365template<class ForwardIterator, class Predicate>
Marshall Clowe00916c2018-01-16 02:34:41 +0000366 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000367 partition_point(ForwardIterator first, ForwardIterator last, Predicate pred);
368
369template <class ForwardIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +0000370 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000371 is_sorted(ForwardIterator first, ForwardIterator last);
372
373template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500374 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000375 is_sorted(ForwardIterator first, ForwardIterator last, Compare comp);
376
377template<class ForwardIterator>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000378 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000379 is_sorted_until(ForwardIterator first, ForwardIterator last);
380
381template <class ForwardIterator, class Compare>
Marshall Clow3c0558f2018-01-15 19:40:34 +0000382 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000383 is_sorted_until(ForwardIterator first, ForwardIterator last, Compare comp);
384
385template <class RandomAccessIterator>
Arthur O'Dwyer1bb0f672020-12-20 15:21:42 -0500386 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000387 sort(RandomAccessIterator first, RandomAccessIterator last);
388
389template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer1bb0f672020-12-20 15:21:42 -0500390 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000391 sort(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
392
393template <class RandomAccessIterator>
394 void
395 stable_sort(RandomAccessIterator first, RandomAccessIterator last);
396
397template <class RandomAccessIterator, class Compare>
398 void
399 stable_sort(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
400
401template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500402 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000403 partial_sort(RandomAccessIterator first, RandomAccessIterator middle, RandomAccessIterator last);
404
405template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500406 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000407 partial_sort(RandomAccessIterator first, RandomAccessIterator middle, RandomAccessIterator last, Compare comp);
408
409template <class InputIterator, class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500410 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000411 partial_sort_copy(InputIterator first, InputIterator last,
412 RandomAccessIterator result_first, RandomAccessIterator result_last);
413
414template <class InputIterator, class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500415 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000416 partial_sort_copy(InputIterator first, InputIterator last,
417 RandomAccessIterator result_first, RandomAccessIterator result_last, Compare comp);
418
419template <class RandomAccessIterator>
Arthur O'Dwyer4f5717b2021-02-04 18:12:52 -0500420 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000421 nth_element(RandomAccessIterator first, RandomAccessIterator nth, RandomAccessIterator last);
422
423template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer4f5717b2021-02-04 18:12:52 -0500424 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000425 nth_element(RandomAccessIterator first, RandomAccessIterator nth, RandomAccessIterator last, Compare comp);
426
427template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000428 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000429 lower_bound(ForwardIterator first, ForwardIterator last, const T& value);
430
431template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000432 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000433 lower_bound(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
434
435template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000436 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000437 upper_bound(ForwardIterator first, ForwardIterator last, const T& value);
438
439template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000440 constexpr ForwardIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000441 upper_bound(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
442
443template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000444 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000445 equal_range(ForwardIterator first, ForwardIterator last, const T& value);
446
447template <class ForwardIterator, class T, class Compare>
Marshall Clowe00916c2018-01-16 02:34:41 +0000448 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000449 equal_range(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
450
451template <class ForwardIterator, class T>
Marshall Clowe00916c2018-01-16 02:34:41 +0000452 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000453 binary_search(ForwardIterator first, ForwardIterator last, const T& value);
454
455template <class ForwardIterator, class T, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000456 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000457 binary_search(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
458
459template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500460 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000461 merge(InputIterator1 first1, InputIterator1 last1,
462 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
463
464template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500465 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000466 merge(InputIterator1 first1, InputIterator1 last1,
467 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
468
469template <class BidirectionalIterator>
470 void
471 inplace_merge(BidirectionalIterator first, BidirectionalIterator middle, BidirectionalIterator last);
472
473template <class BidirectionalIterator, class Compare>
474 void
475 inplace_merge(BidirectionalIterator first, BidirectionalIterator middle, BidirectionalIterator last, Compare comp);
476
477template <class InputIterator1, class InputIterator2>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000478 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000479 includes(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2);
480
481template <class InputIterator1, class InputIterator2, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000482 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000483 includes(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2, Compare comp);
484
485template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500486 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000487 set_union(InputIterator1 first1, InputIterator1 last1,
488 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
489
490template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500491 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000492 set_union(InputIterator1 first1, InputIterator1 last1,
493 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
494
495template <class InputIterator1, class InputIterator2, class OutputIterator>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000496 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000497 set_intersection(InputIterator1 first1, InputIterator1 last1,
498 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
499
500template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Marshall Clowc0b7f972018-01-22 23:10:40 +0000501 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000502 set_intersection(InputIterator1 first1, InputIterator1 last1,
503 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
504
505template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500506 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000507 set_difference(InputIterator1 first1, InputIterator1 last1,
508 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
509
510template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500511 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000512 set_difference(InputIterator1 first1, InputIterator1 last1,
513 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
514
515template <class InputIterator1, class InputIterator2, class OutputIterator>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500516 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000517 set_symmetric_difference(InputIterator1 first1, InputIterator1 last1,
518 InputIterator2 first2, InputIterator2 last2, OutputIterator result);
519
520template <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
Arthur O'Dwyer5afc5692020-12-04 13:47:12 -0500521 constexpr OutputIterator // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000522 set_symmetric_difference(InputIterator1 first1, InputIterator1 last1,
523 InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
524
525template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500526 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000527 push_heap(RandomAccessIterator first, RandomAccessIterator last);
528
529template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500530 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000531 push_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
532
533template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500534 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000535 pop_heap(RandomAccessIterator first, RandomAccessIterator last);
536
537template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500538 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000539 pop_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
540
541template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500542 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000543 make_heap(RandomAccessIterator first, RandomAccessIterator last);
544
545template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500546 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000547 make_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
548
549template <class RandomAccessIterator>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500550 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000551 sort_heap(RandomAccessIterator first, RandomAccessIterator last);
552
553template <class RandomAccessIterator, class Compare>
Arthur O'Dwyer2dfea5d2020-12-17 00:26:18 -0500554 constexpr void // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000555 sort_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
556
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000557template <class RandomAccessIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +0000558 constexpr bool // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000559 is_heap(RandomAccessIterator first, RandomAccessiterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000560
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000561template <class RandomAccessIterator, class Compare>
Marshall Clow96d050a2018-01-15 16:16:32 +0000562 constexpr bool // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000563 is_heap(RandomAccessIterator first, RandomAccessiterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000564
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000565template <class RandomAccessIterator>
Marshall Clow96d050a2018-01-15 16:16:32 +0000566 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000567 is_heap_until(RandomAccessIterator first, RandomAccessiterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000568
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000569template <class RandomAccessIterator, class Compare>
Marshall Clow96d050a2018-01-15 16:16:32 +0000570 constexpr RandomAccessIterator // constexpr in C++20
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000571 is_heap_until(RandomAccessIterator first, RandomAccessiterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000572
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000573template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500574 constexpr ForwardIterator // constexpr in C++14
575 min_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000576
577template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500578 constexpr ForwardIterator // constexpr in C++14
579 min_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000580
Howard Hinnantc51e1022010-05-11 19:42:16 +0000581template <class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500582 constexpr const T& // constexpr in C++14
583 min(const T& a, const T& b);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000584
585template <class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500586 constexpr const T& // constexpr in C++14
587 min(const T& a, const T& b, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000588
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000589template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500590 constexpr T // constexpr in C++14
591 min(initializer_list<T> t);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000592
593template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500594 constexpr T // constexpr in C++14
595 min(initializer_list<T> t, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000596
Marshall Clow3e18d0e2016-03-07 22:43:49 +0000597template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500598 constexpr const T& clamp(const T& v, const T& lo, const T& hi); // C++17
Marshall Clow3e18d0e2016-03-07 22:43:49 +0000599
600template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500601 constexpr const T& clamp(const T& v, const T& lo, const T& hi, Compare comp); // C++17
Marshall Clow3e18d0e2016-03-07 22:43:49 +0000602
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000603template <class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500604 constexpr ForwardIterator // constexpr in C++14
605 max_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000606
607template <class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500608 constexpr ForwardIterator // constexpr in C++14
609 max_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000610
Howard Hinnantc51e1022010-05-11 19:42:16 +0000611template <class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500612 constexpr const T& // constexpr in C++14
613 max(const T& a, const T& b);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000614
615template <class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500616 constexpr const T& // constexpr in C++14
617 max(const T& a, const T& b, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000618
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000619template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500620 constexpr T // constexpr in C++14
621 max(initializer_list<T> t);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000622
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000623template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500624 constexpr T // constexpr in C++14
625 max(initializer_list<T> t, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000626
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000627template<class ForwardIterator>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500628 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++14
629 minmax_element(ForwardIterator first, ForwardIterator last);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000630
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000631template<class ForwardIterator, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500632 constexpr pair<ForwardIterator, ForwardIterator> // constexpr in C++14
633 minmax_element(ForwardIterator first, ForwardIterator last, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000634
635template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500636 constexpr pair<const T&, const T&> // constexpr in C++14
637 minmax(const T& a, const T& b);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000638
639template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500640 constexpr pair<const T&, const T&> // constexpr in C++14
641 minmax(const T& a, const T& b, Compare comp);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000642
643template<class T>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500644 constexpr pair<T, T> // constexpr in C++14
645 minmax(initializer_list<T> t);
Howard Hinnantb120e7a2010-08-21 20:10:01 +0000646
647template<class T, class Compare>
Arthur O'Dwyer20353a72020-12-02 20:02:18 -0500648 constexpr pair<T, T> // constexpr in C++14
649 minmax(initializer_list<T> t, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000650
651template <class InputIterator1, class InputIterator2>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000652 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000653 lexicographical_compare(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2);
654
655template <class InputIterator1, class InputIterator2, class Compare>
Marshall Clow5492c8a2018-01-22 20:44:33 +0000656 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000657 lexicographical_compare(InputIterator1 first1, InputIterator1 last1,
658 InputIterator2 first2, InputIterator2 last2, Compare comp);
659
660template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500661 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000662 next_permutation(BidirectionalIterator first, BidirectionalIterator last);
663
664template <class BidirectionalIterator, class Compare>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500665 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000666 next_permutation(BidirectionalIterator first, BidirectionalIterator last, Compare comp);
667
668template <class BidirectionalIterator>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500669 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000670 prev_permutation(BidirectionalIterator first, BidirectionalIterator last);
671
672template <class BidirectionalIterator, class Compare>
Arthur O'Dwyere50e7472020-12-17 00:01:08 -0500673 constexpr bool // constexpr in C++20
Howard Hinnantc51e1022010-05-11 19:42:16 +0000674 prev_permutation(BidirectionalIterator first, BidirectionalIterator last, Compare comp);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000675} // std
676
677*/
678
Arthur O'Dwyer3693d7a2022-02-04 13:09:30 -0500679#include <__bits>
Howard Hinnantc51e1022010-05-11 19:42:16 +0000680#include <__config>
Louis Dionnea60dd872021-06-17 11:30:11 -0400681#include <__debug>
Howard Hinnant60e5cf42012-07-26 17:09:09 +0000682#include <cstddef>
Arthur O'Dwyeref181602021-05-19 11:57:04 -0400683#include <cstring>
684#include <functional>
685#include <initializer_list>
686#include <iterator>
687#include <memory>
688#include <type_traits>
Arthur O'Dwyer3693d7a2022-02-04 13:09:30 -0500689#include <utility>
Marshall Clow0a1e7502018-09-12 19:41:40 +0000690#include <version>
Howard Hinnantea382952013-08-14 18:00:20 +0000691
Louis Dionnea60dd872021-06-17 11:30:11 -0400692#include <__algorithm/adjacent_find.h>
693#include <__algorithm/all_of.h>
694#include <__algorithm/any_of.h>
695#include <__algorithm/binary_search.h>
696#include <__algorithm/clamp.h>
697#include <__algorithm/comp.h>
698#include <__algorithm/comp_ref_type.h>
699#include <__algorithm/copy.h>
700#include <__algorithm/copy_backward.h>
701#include <__algorithm/copy_if.h>
702#include <__algorithm/copy_n.h>
703#include <__algorithm/count.h>
704#include <__algorithm/count_if.h>
705#include <__algorithm/equal.h>
706#include <__algorithm/equal_range.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400707#include <__algorithm/fill.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -0500708#include <__algorithm/fill_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400709#include <__algorithm/find.h>
710#include <__algorithm/find_end.h>
711#include <__algorithm/find_first_of.h>
712#include <__algorithm/find_if.h>
713#include <__algorithm/find_if_not.h>
714#include <__algorithm/for_each.h>
715#include <__algorithm/for_each_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400716#include <__algorithm/generate.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -0500717#include <__algorithm/generate_n.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400718#include <__algorithm/half_positive.h>
Nikolas Klauser671b4752022-02-11 17:01:58 +0100719#include <__algorithm/in_fun_result.h>
Nikolas Klauser05e2cd82022-01-25 11:21:47 +0100720#include <__algorithm/in_in_out_result.h>
Nikolas Klauserf74be4e2022-01-14 02:55:51 +0100721#include <__algorithm/in_in_result.h>
Nikolas Klauser61ce8162022-02-03 02:17:03 +0100722#include <__algorithm/in_out_out_result.h>
Konstantin Varlamov74736812022-01-10 22:49:37 -0800723#include <__algorithm/in_out_result.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400724#include <__algorithm/includes.h>
725#include <__algorithm/inplace_merge.h>
726#include <__algorithm/is_heap.h>
727#include <__algorithm/is_heap_until.h>
728#include <__algorithm/is_partitioned.h>
729#include <__algorithm/is_permutation.h>
730#include <__algorithm/is_sorted.h>
731#include <__algorithm/is_sorted_until.h>
Christopher Di Bella41f26e82021-06-05 02:47:47 +0000732#include <__algorithm/iter_swap.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400733#include <__algorithm/lexicographical_compare.h>
734#include <__algorithm/lower_bound.h>
735#include <__algorithm/make_heap.h>
736#include <__algorithm/max.h>
737#include <__algorithm/max_element.h>
738#include <__algorithm/merge.h>
739#include <__algorithm/min.h>
740#include <__algorithm/min_element.h>
741#include <__algorithm/minmax.h>
742#include <__algorithm/minmax_element.h>
743#include <__algorithm/mismatch.h>
744#include <__algorithm/move.h>
745#include <__algorithm/move_backward.h>
746#include <__algorithm/next_permutation.h>
747#include <__algorithm/none_of.h>
748#include <__algorithm/nth_element.h>
749#include <__algorithm/partial_sort.h>
750#include <__algorithm/partial_sort_copy.h>
751#include <__algorithm/partition.h>
752#include <__algorithm/partition_copy.h>
753#include <__algorithm/partition_point.h>
754#include <__algorithm/pop_heap.h>
755#include <__algorithm/prev_permutation.h>
756#include <__algorithm/push_heap.h>
Nikolas Klauser0a62a172022-02-11 13:11:57 +0100757#include <__algorithm/ranges_min_element.h>
Nikolas Klauser4ceab5f2022-02-10 13:33:03 +0100758#include <__algorithm/ranges_swap_ranges.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400759#include <__algorithm/remove.h>
760#include <__algorithm/remove_copy.h>
761#include <__algorithm/remove_copy_if.h>
762#include <__algorithm/remove_if.h>
763#include <__algorithm/replace.h>
764#include <__algorithm/replace_copy.h>
765#include <__algorithm/replace_copy_if.h>
766#include <__algorithm/replace_if.h>
767#include <__algorithm/reverse.h>
768#include <__algorithm/reverse_copy.h>
769#include <__algorithm/rotate.h>
770#include <__algorithm/rotate_copy.h>
771#include <__algorithm/sample.h>
772#include <__algorithm/search.h>
773#include <__algorithm/search_n.h>
774#include <__algorithm/set_difference.h>
775#include <__algorithm/set_intersection.h>
776#include <__algorithm/set_symmetric_difference.h>
777#include <__algorithm/set_union.h>
778#include <__algorithm/shift_left.h>
779#include <__algorithm/shift_right.h>
780#include <__algorithm/shuffle.h>
781#include <__algorithm/sift_down.h>
782#include <__algorithm/sort.h>
783#include <__algorithm/sort_heap.h>
784#include <__algorithm/stable_partition.h>
785#include <__algorithm/stable_sort.h>
Christopher Di Bella41f26e82021-06-05 02:47:47 +0000786#include <__algorithm/swap_ranges.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400787#include <__algorithm/transform.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400788#include <__algorithm/unique.h>
Arthur O'Dwyer65077c02022-01-07 09:45:05 -0500789#include <__algorithm/unique_copy.h>
Louis Dionnea60dd872021-06-17 11:30:11 -0400790#include <__algorithm/unwrap_iter.h>
791#include <__algorithm/upper_bound.h>
Eric Fiselier14b6de92014-08-10 23:53:08 +0000792
Howard Hinnantaaaa52b2011-10-17 20:05:10 +0000793#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
Arthur O'Dwyer6eeaa002022-02-01 20:16:40 -0500794# pragma GCC system_header
Howard Hinnantaaaa52b2011-10-17 20:05:10 +0000795#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +0000796
Louis Dionne59d0b3c2019-08-05 18:29:14 +0000797#if defined(_LIBCPP_HAS_PARALLEL_ALGORITHMS) && _LIBCPP_STD_VER >= 17
Louis Dionned53d8c02019-08-06 21:11:24 +0000798# include <__pstl_algorithm>
Louis Dionne59d0b3c2019-08-05 18:29:14 +0000799#endif
800
Louis Dionne2b1ceaa2021-04-20 12:03:32 -0400801#endif // _LIBCPP_ALGORITHM