13e519524SHoward Hinnant// -*- C++ -*-
2eb8650a7SLouis Dionne//===----------------------------------------------------------------------===//
33e519524SHoward Hinnant//
457b08b09SChandler Carruth// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
557b08b09SChandler Carruth// See https://llvm.org/LICENSE.txt for license information.
657b08b09SChandler Carruth// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
73e519524SHoward Hinnant//
83e519524SHoward Hinnant//===----------------------------------------------------------------------===//
93e519524SHoward Hinnant
103e519524SHoward Hinnant#ifndef _LIBCPP_ALGORITHM
113e519524SHoward Hinnant#define _LIBCPP_ALGORITHM
123e519524SHoward Hinnant
133e519524SHoward Hinnant/*
143e519524SHoward Hinnant    algorithm synopsis
153e519524SHoward Hinnant
163e519524SHoward Hinnant#include <initializer_list>
173e519524SHoward Hinnant
183e519524SHoward Hinnantnamespace std
193e519524SHoward Hinnant{
203e519524SHoward Hinnant
21d3729bb3SNikolas Klausernamespace ranges {
221e77b396SNikolas Klauser  template <class I, class F>
231e77b396SNikolas Klauser    struct in_fun_result;     // since C++20
241e77b396SNikolas Klauser
25d3729bb3SNikolas Klauser  template <class I1, class I2>
26d3729bb3SNikolas Klauser    struct in_in_result;      // since C++20
27f3514af4SNikolas Klauser
28f3514af4SNikolas Klauser  template <class I1, class I2, class O>
29f3514af4SNikolas Klauser    struct in_in_out_result;  // since C++20
30610979b3SNikolas Klauser
31610979b3SNikolas Klauser  template <class I, class O1, class O2>
32610979b3SNikolas Klauser    struct in_out_out_result; // since C++20
331e77b396SNikolas Klauser
34807766beSNikolas Klauser  template <class I1, class I2>
35807766beSNikolas Klauser    struct min_max_result;    // since C++20
36807766beSNikolas Klauser
3768f4131cSNikolas Klauser  template <class I>
3868f4131cSNikolas Klauser    struct in_found_result;   // since C++20
3968f4131cSNikolas Klauser
403b470d1cSNikolas Klauser  template<forward_iterator I, sentinel_for<I> S, class Proj = identity,
413b470d1cSNikolas Klauser    indirect_strict_weak_order<projected<I, Proj>> Comp = ranges::less>             // since C++20
423b470d1cSNikolas Klauser  constexpr I min_element(I first, S last, Comp comp = {}, Proj proj = {});
433b470d1cSNikolas Klauser
443b470d1cSNikolas Klauser  template<forward_range R, class Proj = identity,
453b470d1cSNikolas Klauser    indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less> // since C++20
463b470d1cSNikolas Klauser  constexpr borrowed_iterator_t<R> min_element(R&& r, Comp comp = {}, Proj proj = {});
47c2cd15a6SNikolas Klauser
4840f7fca3SNikolas Klauser  template<forward_iterator I, sentinel_for<I> S, class Proj = identity,
4940f7fca3SNikolas Klauser    indirect_strict_weak_order<projected<I, Proj>> Comp = ranges::less>
5040f7fca3SNikolas Klauser  constexpr I ranges::max_element(I first, S last, Comp comp = {}, Proj proj = {});                        // since C++20
5140f7fca3SNikolas Klauser
5240f7fca3SNikolas Klauser  template<forward_range R, class Proj = identity,
5340f7fca3SNikolas Klauser    indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less>
5440f7fca3SNikolas Klauser  constexpr borrowed_iterator_t<R> ranges::max_element(R&& r, Comp comp = {}, Proj proj = {});             // since C++20
5540f7fca3SNikolas Klauser
5640f7fca3SNikolas Klauser
57c2cd15a6SNikolas Klauser  template <input_iterator I1, sentinel_for<_I1> S1, input_iterator I2, sentinel_for<_I2> S2,
58c2cd15a6SNikolas Klauser          class Pred = ranges::equal_to, class Proj1 = identity, class Proj2 = identity>
59c2cd15a6SNikolas Klauser    requires indirectly_comparable<I1, I2, Pred, Proj1, Proj2>
60c2cd15a6SNikolas Klauser  constexpr mismatch_result<_I1, _I2>
61c2cd15a6SNikolas Klauser  mismatch()(I1 first1, S1 last1, I2 first2, S2 last2, Pred pred = {}, Proj1 proj1 = {}, Proj2 proj2 = {}) // since C++20
62c2cd15a6SNikolas Klauser
63c2cd15a6SNikolas Klauser  template <input_range R1, input_range R2,
64c2cd15a6SNikolas Klauser          class Pred = ranges::equal_to, class Proj1 = identity, class Proj2 = identity>
65c2cd15a6SNikolas Klauser    requires indirectly_comparable<iterator_t<R1>, iterator_t<R2>, Pred, Proj1, Proj2>
66c2cd15a6SNikolas Klauser  constexpr mismatch_result<borrowed_iterator_t<R1>, borrowed_iterator_t<R2>>
67c2cd15a6SNikolas Klauser  mismatch(R1&& r1, R2&& r2, Pred pred = {}, Proj1 proj1 = {}, Proj2 proj2 = {})                           // since C++20
68ee0f8c40SNikolas Klauser
69ee0f8c40SNikolas Klauser    requires indirect_binary_predicate<ranges::equal_to, projected<I, Proj>, const T*>
70ee0f8c40SNikolas Klauser    constexpr I find(I first, S last, const T& value, Proj proj = {});              // since C++20
71ee0f8c40SNikolas Klauser
72ee0f8c40SNikolas Klauser  template<input_range R, class T, class Proj = identity>
73ee0f8c40SNikolas Klauser    requires indirect_binary_predicate<ranges::equal_to, projected<iterator_t<R>, Proj>, const T*>
74ee0f8c40SNikolas Klauser    constexpr borrowed_iterator_t<R>
75ee0f8c40SNikolas Klauser      find(R&& r, const T& value, Proj proj = {});                                  // since C++20
76ee0f8c40SNikolas Klauser
77ee0f8c40SNikolas Klauser  template<input_iterator I, sentinel_for<I> S, class Proj = identity,
78ee0f8c40SNikolas Klauser           indirect_unary_predicate<projected<I, Proj>> Pred>
79ee0f8c40SNikolas Klauser    constexpr I find_if(I first, S last, Pred pred, Proj proj = {});                // since C++20
80ee0f8c40SNikolas Klauser
81ee0f8c40SNikolas Klauser  template<input_range R, class Proj = identity,
82ee0f8c40SNikolas Klauser           indirect_unary_predicate<projected<iterator_t<R>, Proj>> Pred>
83ee0f8c40SNikolas Klauser    constexpr borrowed_iterator_t<R>
84ee0f8c40SNikolas Klauser      find_if(R&& r, Pred pred, Proj proj = {});                                    // since C++20
85ee0f8c40SNikolas Klauser
86ee0f8c40SNikolas Klauser  template<input_iterator I, sentinel_for<I> S, class Proj = identity,
87ee0f8c40SNikolas Klauser           indirect_unary_predicate<projected<I, Proj>> Pred>
88ee0f8c40SNikolas Klauser    constexpr I find_if_not(I first, S last, Pred pred, Proj proj = {});            // since C++20
89ee0f8c40SNikolas Klauser
90ee0f8c40SNikolas Klauser  template<input_range R, class Proj = identity,
91ee0f8c40SNikolas Klauser           indirect_unary_predicate<projected<iterator_t<R>, Proj>> Pred>
92ee0f8c40SNikolas Klauser    constexpr borrowed_iterator_t<R>
93ee0f8c40SNikolas Klauser      find_if_not(R&& r, Pred pred, Proj proj = {});                                // since C++20
94f83d833eSNikolas Klauser
95f83d833eSNikolas Klauser  template<class T, class Proj = identity,
96f83d833eSNikolas Klauser           indirect_strict_weak_order<projected<const T*, Proj>> Comp = ranges::less>
97f83d833eSNikolas Klauser    constexpr const T& min(const T& a, const T& b, Comp comp = {}, Proj proj = {}); // since C++20
98f83d833eSNikolas Klauser
99f83d833eSNikolas Klauser  template<copyable T, class Proj = identity,
100f83d833eSNikolas Klauser           indirect_strict_weak_order<projected<const T*, Proj>> Comp = ranges::less>
101f83d833eSNikolas Klauser    constexpr T min(initializer_list<T> r, Comp comp = {}, Proj proj = {});         // since C++20
102f83d833eSNikolas Klauser
103f83d833eSNikolas Klauser template<input_range R, class Proj = identity,
104f83d833eSNikolas Klauser          indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less>
105f83d833eSNikolas Klauser   requires indirectly_copyable_storable<iterator_t<R>, range_value_t<R>*>
106f83d833eSNikolas Klauser   constexpr range_value_t<R>
107f83d833eSNikolas Klauser     min(R&& r, Comp comp = {}, Proj proj = {});                                    // since C++20
108e476df56SNikolas Klauser
109e476df56SNikolas Klauser  template<class T, class Proj = identity,
110e476df56SNikolas Klauser           indirect_strict_weak_order<projected<const T*, Proj>> Comp = ranges::less>
111e476df56SNikolas Klauser    constexpr const T& max(const T& a, const T& b, Comp comp = {}, Proj proj = {}); // since C++20
112e476df56SNikolas Klauser
113e476df56SNikolas Klauser  template<copyable T, class Proj = identity,
114e476df56SNikolas Klauser           indirect_strict_weak_order<projected<const T*, Proj>> Comp = ranges::less>
115e476df56SNikolas Klauser    constexpr T max(initializer_list<T> r, Comp comp = {}, Proj proj = {});         // since C++20
116e476df56SNikolas Klauser
117e476df56SNikolas Klauser  template<input_range R, class Proj = identity,
118e476df56SNikolas Klauser           indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less>
119e476df56SNikolas Klauser    requires indirectly_copyable_storable<iterator_t<R>, range_value_t<R>*>
120e476df56SNikolas Klauser    constexpr range_value_t<R>
121e476df56SNikolas Klauser      max(R&& r, Comp comp = {}, Proj proj = {});                                   // since C++20
1223ba8548cSNikolas Klauser
1233ba8548cSNikolas Klauser  template<class I, class O>
1243ba8548cSNikolas Klauser    using unary_transform_result = in_out_result<I, O>;                             // since C++20
1253ba8548cSNikolas Klauser
1263ba8548cSNikolas Klauser  template<class I1, class I2, class O>
1273ba8548cSNikolas Klauser    using binary_transform_result = in_in_out_result<I1, I2, O>;                    // since C++20
1283ba8548cSNikolas Klauser
1293ba8548cSNikolas Klauser  template<input_iterator I, sentinel_for<I> S, weakly_incrementable O,
1303ba8548cSNikolas Klauser           copy_constructible F, class Proj = identity>
1313ba8548cSNikolas Klauser    requires indirectly_writable<O, indirect_result_t<F&, projected<I, Proj>>>
1323ba8548cSNikolas Klauser    constexpr ranges::unary_transform_result<I, O>
1333ba8548cSNikolas Klauser      transform(I first1, S last1, O result, F op, Proj proj = {});                 // since C++20
1343ba8548cSNikolas Klauser
1353ba8548cSNikolas Klauser  template<input_range R, weakly_incrementable O, copy_constructible F,
1363ba8548cSNikolas Klauser           class Proj = identity>
1373ba8548cSNikolas Klauser    requires indirectly_writable<O, indirect_result_t<F&, projected<iterator_t<R>, Proj>>>
1383ba8548cSNikolas Klauser    constexpr ranges::unary_transform_result<borrowed_iterator_t<R>, O>
1393ba8548cSNikolas Klauser      transform(R&& r, O result, F op, Proj proj = {});                             // since C++20
1403ba8548cSNikolas Klauser
1413ba8548cSNikolas Klauser  template<input_iterator I1, sentinel_for<I1> S1, input_iterator I2, sentinel_for<I2> S2,
1423ba8548cSNikolas Klauser           weakly_incrementable O, copy_constructible F, class Proj1 = identity,
1433ba8548cSNikolas Klauser           class Proj2 = identity>
1443ba8548cSNikolas Klauser    requires indirectly_writable<O, indirect_result_t<F&, projected<I1, Proj1>,
1453ba8548cSNikolas Klauser                                           projected<I2, Proj2>>>
1463ba8548cSNikolas Klauser    constexpr ranges::binary_transform_result<I1, I2, O>
1473ba8548cSNikolas Klauser      transform(I1 first1, S1 last1, I2 first2, S2 last2, O result,
1483ba8548cSNikolas Klauser                        F binary_op, Proj1 proj1 = {}, Proj2 proj2 = {});           // since C++20
1493ba8548cSNikolas Klauser
1503ba8548cSNikolas Klauser  template<input_range R1, input_range R2, weakly_incrementable O,
1513ba8548cSNikolas Klauser           copy_constructible F, class Proj1 = identity, class Proj2 = identity>
1523ba8548cSNikolas Klauser    requires indirectly_writable<O, indirect_result_t<F&, projected<iterator_t<R1>, Proj1>,
1533ba8548cSNikolas Klauser                                           projected<iterator_t<R2>, Proj2>>>
1543ba8548cSNikolas Klauser    constexpr ranges::binary_transform_result<borrowed_iterator_t<R1>, borrowed_iterator_t<R2>, O>
1553ba8548cSNikolas Klauser      transform(R1&& r1, R2&& r2, O result,
1563ba8548cSNikolas Klauser                        F binary_op, Proj1 proj1 = {}, Proj2 proj2 = {});           // since C++20
1571306b102SNikolas Klauser
1581306b102SNikolas Klauser  template<input_iterator I, sentinel_for<I> S, class T, class Proj = identity>
1591306b102SNikolas Klauser    requires indirect_binary_predicate<ranges::equal_to, projected<I, Proj>, const T*>
1601306b102SNikolas Klauser    constexpr iter_difference_t<I>
1611306b102SNikolas Klauser      count(I first, S last, const T& value, Proj proj = {});                       // since C++20
1621306b102SNikolas Klauser
1631306b102SNikolas Klauser  template<input_range R, class T, class Proj = identity>
1641306b102SNikolas Klauser    requires indirect_binary_predicate<ranges::equal_to, projected<iterator_t<R>, Proj>, const T*>
1651306b102SNikolas Klauser    constexpr range_difference_t<R>
1661306b102SNikolas Klauser      count(R&& r, const T& value, Proj proj = {});                                 // since C++20
1671306b102SNikolas Klauser
1681306b102SNikolas Klauser  template<input_iterator I, sentinel_for<I> S, class Proj = identity,
1691306b102SNikolas Klauser           indirect_unary_predicate<projected<I, Proj>> Pred>
1701306b102SNikolas Klauser    constexpr iter_difference_t<I>
1711306b102SNikolas Klauser      count_if(I first, S last, Pred pred, Proj proj = {});                         // since C++20
1721306b102SNikolas Klauser
1731306b102SNikolas Klauser  template<input_range R, class Proj = identity,
1741306b102SNikolas Klauser           indirect_unary_predicate<projected<iterator_t<R>, Proj>> Pred>
1751306b102SNikolas Klauser    constexpr range_difference_t<R>
1761306b102SNikolas Klauser      count_if(R&& r, Pred pred, Proj proj = {});                                   // since C++20
17758d9ab70SNikolas Klauser
17858d9ab70SNikolas Klauser  template<class T, class Proj = identity,
17958d9ab70SNikolas Klauser           indirect_strict_weak_order<projected<const T*, Proj>> Comp = ranges::less>
18058d9ab70SNikolas Klauser    constexpr ranges::minmax_result<const T&>
18158d9ab70SNikolas Klauser      minmax(const T& a, const T& b, Comp comp = {}, Proj proj = {});                     // since C++20
18258d9ab70SNikolas Klauser
18358d9ab70SNikolas Klauser  template<copyable T, class Proj = identity,
18458d9ab70SNikolas Klauser           indirect_strict_weak_order<projected<const T*, Proj>> Comp = ranges::less>
18558d9ab70SNikolas Klauser    constexpr ranges::minmax_result<T>
18658d9ab70SNikolas Klauser      minmax(initializer_list<T> r, Comp comp = {}, Proj proj = {});                      // since C++20
18758d9ab70SNikolas Klauser
18858d9ab70SNikolas Klauser  template<input_range R, class Proj = identity,
18958d9ab70SNikolas Klauser           indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less>
19058d9ab70SNikolas Klauser    requires indirectly_copyable_storable<iterator_t<R>, range_value_t<R>*>
19158d9ab70SNikolas Klauser    constexpr ranges::minmax_result<range_value_t<R>>
19258d9ab70SNikolas Klauser      minmax(R&& r, Comp comp = {}, Proj proj = {});                                      // since C++20
19358d9ab70SNikolas Klauser
19458d9ab70SNikolas Klauser  template<forward_iterator I, sentinel_for<I> S, class Proj = identity,
19558d9ab70SNikolas Klauser           indirect_strict_weak_order<projected<I, Proj>> Comp = ranges::less>
19658d9ab70SNikolas Klauser    constexpr ranges::minmax_element_result<I>
19758d9ab70SNikolas Klauser      minmax_element(I first, S last, Comp comp = {}, Proj proj = {});                    // since C++20
19858d9ab70SNikolas Klauser
19958d9ab70SNikolas Klauser  template<forward_range R, class Proj = identity,
20058d9ab70SNikolas Klauser           indirect_strict_weak_order<projected<iterator_t<R>, Proj>> Comp = ranges::less>
20158d9ab70SNikolas Klauser    constexpr ranges::minmax_element_result<borrowed_iterator_t<R>>
20258d9ab70SNikolas Klauser      minmax_element(R&& r, Comp comp = {}, Proj proj = {});                              // since C++20
2031d83750fSNikolas Klauser
2041d83750fSNikolas Klauser  template<class I, class O>
2051d83750fSNikolas Klauser      using copy_result = in_out_result<I, O>;                                              // since C++20
2061d83750fSNikolas Klauser
2071d83750fSNikolas Klauser    template<class I, class O>
2081d83750fSNikolas Klauser      using copy_n_result = in_out_result<I, O>;                                            // since C++20
2091d83750fSNikolas Klauser
2101d83750fSNikolas Klauser  template<class I, class O>
2111d83750fSNikolas Klauser    using copy_if_result = in_out_result<I, O>;                                             // since C++20
2121d83750fSNikolas Klauser
2131d83750fSNikolas Klauser  template<class I1, class I2>
2141d83750fSNikolas Klauser    using copy_backward_result = in_out_result<I1, I2>;                                     // since C++20
2151d83750fSNikolas Klauser
2161d83750fSNikolas Klauser  template<input_iterator I, sentinel_for<I> S, weakly_incrementable O>
2171d83750fSNikolas Klauser    requires indirectly_copyable<I, O>
2181d83750fSNikolas Klauser    constexpr ranges::copy_result<I, O> ranges::copy(I first, S last, O result);            // since C++20
2191d83750fSNikolas Klauser
2201d83750fSNikolas Klauser  template<input_range R, weakly_incrementable O>
2211d83750fSNikolas Klauser    requires indirectly_copyable<iterator_t<R>, O>
2221d83750fSNikolas Klauser    constexpr ranges::copy_result<borrowed_iterator_t<R>, O> ranges::copy(R&& r, O result); // since C++20
2231d83750fSNikolas Klauser
2241d83750fSNikolas Klauser  template<input_iterator I, weakly_incrementable O>
2251d83750fSNikolas Klauser    requires indirectly_copyable<I, O>
2261d83750fSNikolas Klauser    constexpr ranges::copy_n_result<I, O>
2271d83750fSNikolas Klauser      ranges::copy_n(I first, iter_difference_t<I> n, O result);                            // since C++20
2281d83750fSNikolas Klauser
2291d83750fSNikolas Klauser  template<input_iterator I, sentinel_for<I> S, weakly_incrementable O, class Proj = identity,
2301d83750fSNikolas Klauser           indirect_unary_predicate<projected<I, Proj>> Pred>
2311d83750fSNikolas Klauser    requires indirectly_copyable<I, O>
2321d83750fSNikolas Klauser    constexpr ranges::copy_if_result<I, O>
2331d83750fSNikolas Klauser      ranges::copy_if(I first, S last, O result, Pred pred, Proj proj = {});                // since C++20
2341d83750fSNikolas Klauser
2351d83750fSNikolas Klauser  template<input_range R, weakly_incrementable O, class Proj = identity,
2361d83750fSNikolas Klauser           indirect_unary_predicate<projected<iterator_t<R>, Proj>> Pred>
2371d83750fSNikolas Klauser    requires indirectly_copyable<iterator_t<R>, O>
2381d83750fSNikolas Klauser    constexpr ranges::copy_if_result<borrowed_iterator_t<R>, O>
2391d83750fSNikolas Klauser      ranges::copy_if(R&& r, O result, Pred pred, Proj proj = {});                          // since C++20
2401d83750fSNikolas Klauser
2411d83750fSNikolas Klauser  template<bidirectional_iterator I1, sentinel_for<I1> S1, bidirectional_iterator I2>
2421d83750fSNikolas Klauser    requires indirectly_copyable<I1, I2>
2431d83750fSNikolas Klauser    constexpr ranges::copy_backward_result<I1, I2>
2441d83750fSNikolas Klauser      ranges::copy_backward(I1 first, S1 last, I2 result);                                  // since C++20
2451d83750fSNikolas Klauser
2461d83750fSNikolas Klauser  template<bidirectional_range R, bidirectional_iterator I>
2471d83750fSNikolas Klauser    requires indirectly_copyable<iterator_t<R>, I>
2481d83750fSNikolas Klauser    constexpr ranges::copy_backward_result<borrowed_iterator_t<R>, I>
2491d83750fSNikolas Klauser      ranges::copy_backward(R&& r, I result);                                               // since C++20
25080045e9aSNikolas Klauser
25180045e9aSNikolas Klauser  template<class I, class F>
25280045e9aSNikolas Klauser    using for_each_result = in_fun_result<I, F>;                                            // since C++20
25380045e9aSNikolas Klauser
25480045e9aSNikolas Klauser  template<input_iterator I, sentinel_for<I> S, class Proj = identity,
25580045e9aSNikolas Klauser           indirectly_unary_invocable<projected<I, Proj>> Fun>
25680045e9aSNikolas Klauser    constexpr ranges::for_each_result<I, Fun>
25780045e9aSNikolas Klauser      ranges::for_each(I first, S last, Fun f, Proj proj = {});                             // since C++20
25880045e9aSNikolas Klauser
25980045e9aSNikolas Klauser  template<input_range R, class Proj = identity,
26080045e9aSNikolas Klauser           indirectly_unary_invocable<projected<iterator_t<R>, Proj>> Fun>
26180045e9aSNikolas Klauser    constexpr ranges::for_each_result<borrowed_iterator_t<R>, Fun>
26280045e9aSNikolas Klauser      ranges::for_each(R&& r, Fun f, Proj proj = {});                                       // since C++20
26380045e9aSNikolas Klauser
26480045e9aSNikolas Klauser  template<input_iterator I, class Proj = identity,
26580045e9aSNikolas Klauser           indirectly_unary_invocable<projected<I, Proj>> Fun>
26680045e9aSNikolas Klauser    constexpr ranges::for_each_n_result<I, Fun>
26780045e9aSNikolas Klauser      ranges::for_each_n(I first, iter_difference_t<I> n, Fun f, Proj proj = {});           // since C++20
26837ba1b9dSNikolas Klauser
26937ba1b9dSNikolas Klauser  template<input_iterator I, sentinel_for<I> S, class Proj = identity,
27037ba1b9dSNikolas Klauser           indirect_unary_predicate<projected<I, Proj>> Pred>
27137ba1b9dSNikolas Klauser    constexpr bool ranges::is_partitioned(I first, S last, Pred pred, Proj proj = {});      // since C++20
27237ba1b9dSNikolas Klauser
27337ba1b9dSNikolas Klauser  template<input_range R, class Proj = identity,
27437ba1b9dSNikolas Klauser           indirect_unary_predicate<projected<iterator_t<R>, Proj>> Pred>
27537ba1b9dSNikolas Klauser    constexpr bool ranges::is_partitioned(R&& r, Pred pred, Proj proj = {});                // since C++20
27637ba1b9dSNikolas Klauser
2771d1a191eSNikolas Klauser
2781d1a191eSNikolas Klauser  template<bidirectional_iterator I, sentinel_for<I> S>
2791d1a191eSNikolas Klauser    requires permutable<I>
2801d1a191eSNikolas Klauser    constexpr I ranges::reverse(I first, S last);                                           // since C++20
2811d1a191eSNikolas Klauser
2821d1a191eSNikolas Klauser  template<bidirectional_range R>
2831d1a191eSNikolas Klauser    requires permutable<iterator_t<R>>
2841d1a191eSNikolas Klauser    constexpr borrowed_iterator_t<R> ranges::reverse(R&& r);                                // since C++20
2851d1a191eSNikolas Klauser
2867af89a37SNikolas Klauser  template<class T, output_iterator<const T&> O, sentinel_for<O> S>
2877af89a37SNikolas Klauser    constexpr O ranges::fill(O first, S last, const T& value);                              // since C++20
2887af89a37SNikolas Klauser
2897af89a37SNikolas Klauser  template<class T, output_range<const T&> R>
2907af89a37SNikolas Klauser    constexpr borrowed_iterator_t<R> ranges::fill(R&& r, const T& value);                   // since C++20
2917af89a37SNikolas Klauser
2927af89a37SNikolas Klauser  template<class T, output_iterator<const T&> O>
2937af89a37SNikolas Klauser    constexpr O ranges::fill_n(O first, iter_difference_t<O> n, const T& value);            // since C++20
294*569d6630SNikolas Klauser
295*569d6630SNikolas Klauser template<input_iterator I1, sentinel_for<I1> S1, input_iterator I2, sentinel_for<I2> S2,
296*569d6630SNikolas Klauser          class Pred = ranges::equal_to, class Proj1 = identity, class Proj2 = identity>
297*569d6630SNikolas Klauser   requires indirectly_comparable<I1, I2, Pred, Proj1, Proj2>
298*569d6630SNikolas Klauser   constexpr bool ranges::equal(I1 first1, S1 last1, I2 first2, S2 last2,
299*569d6630SNikolas Klauser                                Pred pred = {},
300*569d6630SNikolas Klauser                                Proj1 proj1 = {}, Proj2 proj2 = {});                        // since C++20
301*569d6630SNikolas Klauser
302*569d6630SNikolas Klauser template<input_range R1, input_range R2, class Pred = ranges::equal_to,
303*569d6630SNikolas Klauser          class Proj1 = identity, class Proj2 = identity>
304*569d6630SNikolas Klauser   requires indirectly_comparable<iterator_t<R1>, iterator_t<R2>, Pred, Proj1, Proj2>
305*569d6630SNikolas Klauser   constexpr bool ranges::equal(R1&& r1, R2&& r2, Pred pred = {},
306*569d6630SNikolas Klauser                                Proj1 proj1 = {}, Proj2 proj2 = {});                        // since C++20
307*569d6630SNikolas Klauser
308d3729bb3SNikolas Klauser}
309d3729bb3SNikolas Klauser
310706ffef7SMarshall Clow    constexpr bool     // constexpr in C++20
3113e519524SHoward Hinnant    all_of(InputIterator first, InputIterator last, Predicate pred);
3123e519524SHoward Hinnant
3133e519524SHoward Hinnanttemplate <class InputIterator, class Predicate>
314706ffef7SMarshall Clow    constexpr bool     // constexpr in C++20
3153e519524SHoward Hinnant    any_of(InputIterator first, InputIterator last, Predicate pred);
3163e519524SHoward Hinnant
3173e519524SHoward Hinnanttemplate <class InputIterator, class Predicate>
318706ffef7SMarshall Clow    constexpr bool     // constexpr in C++20
3193e519524SHoward Hinnant    none_of(InputIterator first, InputIterator last, Predicate pred);
3203e519524SHoward Hinnant
3213e519524SHoward Hinnanttemplate <class InputIterator, class Function>
3221b9a4ffdSMarshall Clow    constexpr Function          // constexpr in C++20
3233e519524SHoward Hinnant    for_each(InputIterator first, InputIterator last, Function f);
3243e519524SHoward Hinnant
325d5c65ffaSMarshall Clowtemplate<class InputIterator, class Size, class Function>
3261b9a4ffdSMarshall Clow    constexpr InputIterator     // constexpr in C++20
3271b9a4ffdSMarshall Clow    for_each_n(InputIterator first, Size n, Function f); // C++17
328d5c65ffaSMarshall Clow
3293e519524SHoward Hinnanttemplate <class InputIterator, class T>
33049c7643cSMarshall Clow    constexpr InputIterator     // constexpr in C++20
3313e519524SHoward Hinnant    find(InputIterator first, InputIterator last, const T& value);
3323e519524SHoward Hinnant
3333e519524SHoward Hinnanttemplate <class InputIterator, class Predicate>
33449c7643cSMarshall Clow    constexpr InputIterator     // constexpr in C++20
3353e519524SHoward Hinnant    find_if(InputIterator first, InputIterator last, Predicate pred);
3363e519524SHoward Hinnant
3373e519524SHoward Hinnanttemplate<class InputIterator, class Predicate>
338b8bc4e15SArthur O'Dwyer    constexpr InputIterator     // constexpr in C++20
3393e519524SHoward Hinnant    find_if_not(InputIterator first, InputIterator last, Predicate pred);
3403e519524SHoward Hinnant
3413e519524SHoward Hinnanttemplate <class ForwardIterator1, class ForwardIterator2>
342b8bc4e15SArthur O'Dwyer    constexpr ForwardIterator1  // constexpr in C++20
3433e519524SHoward Hinnant    find_end(ForwardIterator1 first1, ForwardIterator1 last1,
3443e519524SHoward Hinnant             ForwardIterator2 first2, ForwardIterator2 last2);
3453e519524SHoward Hinnant
3463e519524SHoward Hinnanttemplate <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
347b8bc4e15SArthur O'Dwyer    constexpr ForwardIterator1  // constexpr in C++20
3483e519524SHoward Hinnant    find_end(ForwardIterator1 first1, ForwardIterator1 last1,
3493e519524SHoward Hinnant             ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
3503e519524SHoward Hinnant
3513e519524SHoward Hinnanttemplate <class ForwardIterator1, class ForwardIterator2>
3528694428eSMarshall Clow    constexpr ForwardIterator1  // constexpr in C++20
3533e519524SHoward Hinnant    find_first_of(ForwardIterator1 first1, ForwardIterator1 last1,
3543e519524SHoward Hinnant                  ForwardIterator2 first2, ForwardIterator2 last2);
3553e519524SHoward Hinnant
3563e519524SHoward Hinnanttemplate <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
3578694428eSMarshall Clow    constexpr ForwardIterator1  // constexpr in C++20
3583e519524SHoward Hinnant    find_first_of(ForwardIterator1 first1, ForwardIterator1 last1,
3593e519524SHoward Hinnant                  ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
3603e519524SHoward Hinnant
3613e519524SHoward Hinnanttemplate <class ForwardIterator>
3628694428eSMarshall Clow    constexpr ForwardIterator   // constexpr in C++20
3633e519524SHoward Hinnant    adjacent_find(ForwardIterator first, ForwardIterator last);
3643e519524SHoward Hinnant
3653e519524SHoward Hinnanttemplate <class ForwardIterator, class BinaryPredicate>
3668694428eSMarshall Clow    constexpr ForwardIterator   // constexpr in C++20
3673e519524SHoward Hinnant    adjacent_find(ForwardIterator first, ForwardIterator last, BinaryPredicate pred);
3683e519524SHoward Hinnant
3693e519524SHoward Hinnanttemplate <class InputIterator, class T>
370056f15e3SMarshall Clow    constexpr typename iterator_traits<InputIterator>::difference_type  // constexpr in C++20
3713e519524SHoward Hinnant    count(InputIterator first, InputIterator last, const T& value);
3723e519524SHoward Hinnant
3733e519524SHoward Hinnanttemplate <class InputIterator, class Predicate>
374056f15e3SMarshall Clow    constexpr typename iterator_traits<InputIterator>::difference_type // constexpr in C++20
3753e519524SHoward Hinnant    count_if(InputIterator first, InputIterator last, Predicate pred);
3763e519524SHoward Hinnant
3773e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2>
3786538e28dSMarshall Clow    constexpr pair<InputIterator1, InputIterator2>   // constexpr in C++20
3793e519524SHoward Hinnant    mismatch(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2);
3803e519524SHoward Hinnant
3810b0bbd2fSMarshall Clowtemplate <class InputIterator1, class InputIterator2>
3826538e28dSMarshall Clow    constexpr pair<InputIterator1, InputIterator2>   // constexpr in C++20
3830b0bbd2fSMarshall Clow    mismatch(InputIterator1 first1, InputIterator1 last1,
3840b0bbd2fSMarshall Clow             InputIterator2 first2, InputIterator2 last2); // **C++14**
3850b0bbd2fSMarshall Clow
3863e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2, class BinaryPredicate>
3876538e28dSMarshall Clow    constexpr pair<InputIterator1, InputIterator2>   // constexpr in C++20
3883e519524SHoward Hinnant    mismatch(InputIterator1 first1, InputIterator1 last1,
3893e519524SHoward Hinnant             InputIterator2 first2, BinaryPredicate pred);
3903e519524SHoward Hinnant
3910b0bbd2fSMarshall Clowtemplate <class InputIterator1, class InputIterator2, class BinaryPredicate>
3926538e28dSMarshall Clow    constexpr pair<InputIterator1, InputIterator2>   // constexpr in C++20
3930b0bbd2fSMarshall Clow    mismatch(InputIterator1 first1, InputIterator1 last1,
3940b0bbd2fSMarshall Clow             InputIterator2 first2, InputIterator2 last2,
3950b0bbd2fSMarshall Clow             BinaryPredicate pred); // **C++14**
3960b0bbd2fSMarshall Clow
3973e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2>
3986538e28dSMarshall Clow    constexpr bool      // constexpr in C++20
3993e519524SHoward Hinnant    equal(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2);
4003e519524SHoward Hinnant
4010b0bbd2fSMarshall Clowtemplate <class InputIterator1, class InputIterator2>
4026538e28dSMarshall Clow    constexpr bool      // constexpr in C++20
4030b0bbd2fSMarshall Clow    equal(InputIterator1 first1, InputIterator1 last1,
4040b0bbd2fSMarshall Clow          InputIterator2 first2, InputIterator2 last2); // **C++14**
4050b0bbd2fSMarshall Clow
4063e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2, class BinaryPredicate>
4076538e28dSMarshall Clow    constexpr bool      // constexpr in C++20
4083e519524SHoward Hinnant    equal(InputIterator1 first1, InputIterator1 last1,
4093e519524SHoward Hinnant          InputIterator2 first2, BinaryPredicate pred);
4103e519524SHoward Hinnant
4110b0bbd2fSMarshall Clowtemplate <class InputIterator1, class InputIterator2, class BinaryPredicate>
4126538e28dSMarshall Clow    constexpr bool      // constexpr in C++20
4130b0bbd2fSMarshall Clow    equal(InputIterator1 first1, InputIterator1 last1,
4140b0bbd2fSMarshall Clow          InputIterator2 first2, InputIterator2 last2,
4150b0bbd2fSMarshall Clow          BinaryPredicate pred); // **C++14**
4160b0bbd2fSMarshall Clow
4173e519524SHoward Hinnanttemplate<class ForwardIterator1, class ForwardIterator2>
41849c7643cSMarshall Clow    constexpr bool      // constexpr in C++20
4193e519524SHoward Hinnant    is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
4203e519524SHoward Hinnant                   ForwardIterator2 first2);
4213e519524SHoward Hinnant
4220b0bbd2fSMarshall Clowtemplate<class ForwardIterator1, class ForwardIterator2>
42349c7643cSMarshall Clow    constexpr bool      // constexpr in C++20
4240b0bbd2fSMarshall Clow    is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
4250b0bbd2fSMarshall Clow                   ForwardIterator2 first2, ForwardIterator2 last2); // **C++14**
4260b0bbd2fSMarshall Clow
4273e519524SHoward Hinnanttemplate<class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
42849c7643cSMarshall Clow    constexpr bool      // constexpr in C++20
4293e519524SHoward Hinnant    is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
4303e519524SHoward Hinnant                   ForwardIterator2 first2, BinaryPredicate pred);
4313e519524SHoward Hinnant
4320b0bbd2fSMarshall Clowtemplate<class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
43349c7643cSMarshall Clow    constexpr bool      // constexpr in C++20
4340b0bbd2fSMarshall Clow    is_permutation(ForwardIterator1 first1, ForwardIterator1 last1,
4350b0bbd2fSMarshall Clow                   ForwardIterator2 first2, ForwardIterator2 last2,
4360b0bbd2fSMarshall Clow                   BinaryPredicate pred);  // **C++14**
4370b0bbd2fSMarshall Clow
4383e519524SHoward Hinnanttemplate <class ForwardIterator1, class ForwardIterator2>
43912f0a779SMarshall Clow    constexpr ForwardIterator1      // constexpr in C++20
4403e519524SHoward Hinnant    search(ForwardIterator1 first1, ForwardIterator1 last1,
4413e519524SHoward Hinnant           ForwardIterator2 first2, ForwardIterator2 last2);
4423e519524SHoward Hinnant
4433e519524SHoward Hinnanttemplate <class ForwardIterator1, class ForwardIterator2, class BinaryPredicate>
44412f0a779SMarshall Clow    constexpr ForwardIterator1      // constexpr in C++20
4453e519524SHoward Hinnant    search(ForwardIterator1 first1, ForwardIterator1 last1,
4463e519524SHoward Hinnant           ForwardIterator2 first2, ForwardIterator2 last2, BinaryPredicate pred);
4473e519524SHoward Hinnant
4483e519524SHoward Hinnanttemplate <class ForwardIterator, class Size, class T>
44912f0a779SMarshall Clow    constexpr ForwardIterator       // constexpr in C++20
4503e519524SHoward Hinnant    search_n(ForwardIterator first, ForwardIterator last, Size count, const T& value);
4513e519524SHoward Hinnant
4523e519524SHoward Hinnanttemplate <class ForwardIterator, class Size, class T, class BinaryPredicate>
45312f0a779SMarshall Clow    constexpr ForwardIterator       // constexpr in C++20
4543e519524SHoward Hinnant    search_n(ForwardIterator first, ForwardIterator last,
4553e519524SHoward Hinnant             Size count, const T& value, BinaryPredicate pred);
4563e519524SHoward Hinnant
4573e519524SHoward Hinnanttemplate <class InputIterator, class OutputIterator>
45813c90a57SLouis Dionne    constexpr OutputIterator      // constexpr in C++20
4593e519524SHoward Hinnant    copy(InputIterator first, InputIterator last, OutputIterator result);
4603e519524SHoward Hinnant
4613e519524SHoward Hinnanttemplate<class InputIterator, class OutputIterator, class Predicate>
46213c90a57SLouis Dionne    constexpr OutputIterator      // constexpr in C++20
4633e519524SHoward Hinnant    copy_if(InputIterator first, InputIterator last,
4643e519524SHoward Hinnant            OutputIterator result, Predicate pred);
4653e519524SHoward Hinnant
4663e519524SHoward Hinnanttemplate<class InputIterator, class Size, class OutputIterator>
46713c90a57SLouis Dionne    constexpr OutputIterator      // constexpr in C++20
4683e519524SHoward Hinnant    copy_n(InputIterator first, Size n, OutputIterator result);
4693e519524SHoward Hinnant
4703e519524SHoward Hinnanttemplate <class BidirectionalIterator1, class BidirectionalIterator2>
47113c90a57SLouis Dionne    constexpr BidirectionalIterator2      // constexpr in C++20
4723e519524SHoward Hinnant    copy_backward(BidirectionalIterator1 first, BidirectionalIterator1 last,
4733e519524SHoward Hinnant                  BidirectionalIterator2 result);
4743e519524SHoward Hinnant
4753e519524SHoward Hinnanttemplate <class ForwardIterator1, class ForwardIterator2>
476b8bc4e15SArthur O'Dwyer    constexpr ForwardIterator2    // constexpr in C++20
4773e519524SHoward Hinnant    swap_ranges(ForwardIterator1 first1, ForwardIterator1 last1, ForwardIterator2 first2);
4783e519524SHoward Hinnant
4799d905319SNikolas Klausertemplate<input_iterator I1, sentinel_for<I1> S1, input_iterator I2, sentinel_for<I2> S2>
4809d905319SNikolas Klauser        requires indirectly_swappable<I1, I2>
4819d905319SNikolas Klauser    constexpr ranges::swap_ranges_result<I1, I2>
4829d905319SNikolas Klauser        ranges::swap_ranges(I1 first1, S1 last1, I2 first2, S2 last2);
4839d905319SNikolas Klauser
4849d905319SNikolas Klausertemplate<input_range R1, input_range R2>
4859d905319SNikolas Klauser        requires indirectly_swappable<iterator_t<R1>, iterator_t<R2>>
4869d905319SNikolas Klauser    constexpr ranges::swap_ranges_result<borrowed_iterator_t<R1>, borrowed_iterator_t<R2>>
4879d905319SNikolas Klauser        ranges::swap_ranges(R1&& r1, R2&& r2);
4889d905319SNikolas Klauser
4893e519524SHoward Hinnanttemplate <class ForwardIterator1, class ForwardIterator2>
490b8bc4e15SArthur O'Dwyer    constexpr void                // constexpr in C++20
4913e519524SHoward Hinnant    iter_swap(ForwardIterator1 a, ForwardIterator2 b);
4923e519524SHoward Hinnant
4933e519524SHoward Hinnanttemplate <class InputIterator, class OutputIterator, class UnaryOperation>
49499894b61SMarshall Clow    constexpr OutputIterator      // constexpr in C++20
4953e519524SHoward Hinnant    transform(InputIterator first, InputIterator last, OutputIterator result, UnaryOperation op);
4963e519524SHoward Hinnant
4973e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2, class OutputIterator, class BinaryOperation>
49899894b61SMarshall Clow    constexpr OutputIterator      // constexpr in C++20
4993e519524SHoward Hinnant    transform(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2,
5003e519524SHoward Hinnant              OutputIterator result, BinaryOperation binary_op);
5013e519524SHoward Hinnant
5023e519524SHoward Hinnanttemplate <class ForwardIterator, class T>
50312c7423fSMarshall Clow    constexpr void      // constexpr in C++20
5043e519524SHoward Hinnant    replace(ForwardIterator first, ForwardIterator last, const T& old_value, const T& new_value);
5053e519524SHoward Hinnant
5063e519524SHoward Hinnanttemplate <class ForwardIterator, class Predicate, class T>
50712c7423fSMarshall Clow    constexpr void      // constexpr in C++20
5083e519524SHoward Hinnant    replace_if(ForwardIterator first, ForwardIterator last, Predicate pred, const T& new_value);
5093e519524SHoward Hinnant
5103e519524SHoward Hinnanttemplate <class InputIterator, class OutputIterator, class T>
51112c7423fSMarshall Clow    constexpr OutputIterator      // constexpr in C++20
5123e519524SHoward Hinnant    replace_copy(InputIterator first, InputIterator last, OutputIterator result,
5133e519524SHoward Hinnant                 const T& old_value, const T& new_value);
5143e519524SHoward Hinnant
5153e519524SHoward Hinnanttemplate <class InputIterator, class OutputIterator, class Predicate, class T>
51612c7423fSMarshall Clow    constexpr OutputIterator      // constexpr in C++20
5173e519524SHoward Hinnant    replace_copy_if(InputIterator first, InputIterator last, OutputIterator result, Predicate pred, const T& new_value);
5183e519524SHoward Hinnant
5193e519524SHoward Hinnanttemplate <class ForwardIterator, class T>
5204bfb9313SMarshall Clow    constexpr void      // constexpr in C++20
5213e519524SHoward Hinnant    fill(ForwardIterator first, ForwardIterator last, const T& value);
5223e519524SHoward Hinnant
5233e519524SHoward Hinnanttemplate <class OutputIterator, class Size, class T>
5244bfb9313SMarshall Clow    constexpr OutputIterator      // constexpr in C++20
5253e519524SHoward Hinnant    fill_n(OutputIterator first, Size n, const T& value);
5263e519524SHoward Hinnant
5273e519524SHoward Hinnanttemplate <class ForwardIterator, class Generator>
5284bfb9313SMarshall Clow    constexpr void      // constexpr in C++20
5293e519524SHoward Hinnant    generate(ForwardIterator first, ForwardIterator last, Generator gen);
5303e519524SHoward Hinnant
5313e519524SHoward Hinnanttemplate <class OutputIterator, class Size, class Generator>
5324bfb9313SMarshall Clow    constexpr OutputIterator      // constexpr in C++20
5333e519524SHoward Hinnant    generate_n(OutputIterator first, Size n, Generator gen);
5343e519524SHoward Hinnant
5353e519524SHoward Hinnanttemplate <class ForwardIterator, class T>
536e8ea8296SMarshall Clow    constexpr ForwardIterator     // constexpr in C++20
5373e519524SHoward Hinnant    remove(ForwardIterator first, ForwardIterator last, const T& value);
5383e519524SHoward Hinnant
5393e519524SHoward Hinnanttemplate <class ForwardIterator, class Predicate>
540e8ea8296SMarshall Clow    constexpr ForwardIterator     // constexpr in C++20
5413e519524SHoward Hinnant    remove_if(ForwardIterator first, ForwardIterator last, Predicate pred);
5423e519524SHoward Hinnant
5433e519524SHoward Hinnanttemplate <class InputIterator, class OutputIterator, class T>
544e8ea8296SMarshall Clow    constexpr OutputIterator     // constexpr in C++20
5453e519524SHoward Hinnant    remove_copy(InputIterator first, InputIterator last, OutputIterator result, const T& value);
5463e519524SHoward Hinnant
5473e519524SHoward Hinnanttemplate <class InputIterator, class OutputIterator, class Predicate>
548e8ea8296SMarshall Clow    constexpr OutputIterator     // constexpr in C++20
5493e519524SHoward Hinnant    remove_copy_if(InputIterator first, InputIterator last, OutputIterator result, Predicate pred);
5503e519524SHoward Hinnant
5513e519524SHoward Hinnanttemplate <class ForwardIterator>
552b8bc4e15SArthur O'Dwyer    constexpr ForwardIterator    // constexpr in C++20
5533e519524SHoward Hinnant    unique(ForwardIterator first, ForwardIterator last);
5543e519524SHoward Hinnant
5553e519524SHoward Hinnanttemplate <class ForwardIterator, class BinaryPredicate>
556b8bc4e15SArthur O'Dwyer    constexpr ForwardIterator    // constexpr in C++20
5573e519524SHoward Hinnant    unique(ForwardIterator first, ForwardIterator last, BinaryPredicate pred);
5583e519524SHoward Hinnant
5593e519524SHoward Hinnanttemplate <class InputIterator, class OutputIterator>
560b8bc4e15SArthur O'Dwyer    constexpr OutputIterator     // constexpr in C++20
5613e519524SHoward Hinnant    unique_copy(InputIterator first, InputIterator last, OutputIterator result);
5623e519524SHoward Hinnant
5633e519524SHoward Hinnanttemplate <class InputIterator, class OutputIterator, class BinaryPredicate>
564b8bc4e15SArthur O'Dwyer    constexpr OutputIterator     // constexpr in C++20
5653e519524SHoward Hinnant    unique_copy(InputIterator first, InputIterator last, OutputIterator result, BinaryPredicate pred);
5663e519524SHoward Hinnant
5673e519524SHoward Hinnanttemplate <class BidirectionalIterator>
568f851db3dSArthur O'Dwyer    constexpr void               // constexpr in C++20
5693e519524SHoward Hinnant    reverse(BidirectionalIterator first, BidirectionalIterator last);
5703e519524SHoward Hinnant
5713e519524SHoward Hinnanttemplate <class BidirectionalIterator, class OutputIterator>
572e8ea8296SMarshall Clow    constexpr OutputIterator       // constexpr in C++20
5733e519524SHoward Hinnant    reverse_copy(BidirectionalIterator first, BidirectionalIterator last, OutputIterator result);
5743e519524SHoward Hinnant
5753e519524SHoward Hinnanttemplate <class ForwardIterator>
576b8bc4e15SArthur O'Dwyer    constexpr ForwardIterator      // constexpr in C++20
5773e519524SHoward Hinnant    rotate(ForwardIterator first, ForwardIterator middle, ForwardIterator last);
5783e519524SHoward Hinnant
5793e519524SHoward Hinnanttemplate <class ForwardIterator, class OutputIterator>
580b8bc4e15SArthur O'Dwyer    constexpr OutputIterator       // constexpr in C++20
5813e519524SHoward Hinnant    rotate_copy(ForwardIterator first, ForwardIterator middle, ForwardIterator last, OutputIterator result);
5823e519524SHoward Hinnant
5833e519524SHoward Hinnanttemplate <class RandomAccessIterator>
5843e519524SHoward Hinnant    void
5850f37a410SMarshall Clow    random_shuffle(RandomAccessIterator first, RandomAccessIterator last); // deprecated in C++14, removed in C++17
5863e519524SHoward Hinnant
5873e519524SHoward Hinnanttemplate <class RandomAccessIterator, class RandomNumberGenerator>
5883e519524SHoward Hinnant    void
58906965c1fSMarshall Clow    random_shuffle(RandomAccessIterator first, RandomAccessIterator last,
5900f37a410SMarshall Clow                   RandomNumberGenerator& rand);  // deprecated in C++14, removed in C++17
5913e519524SHoward Hinnant
592e7154709SEric Fiseliertemplate<class PopulationIterator, class SampleIterator,
593e7154709SEric Fiselier         class Distance, class UniformRandomBitGenerator>
594e7154709SEric Fiselier    SampleIterator sample(PopulationIterator first, PopulationIterator last,
595e7154709SEric Fiselier                          SampleIterator out, Distance n,
596e7154709SEric Fiselier                          UniformRandomBitGenerator&& g); // C++17
597e7154709SEric Fiselier
598f9d540b0SHoward Hinnanttemplate<class RandomAccessIterator, class UniformRandomNumberGenerator>
599f9d540b0SHoward Hinnant    void shuffle(RandomAccessIterator first, RandomAccessIterator last,
600fb340102SHoward Hinnant                 UniformRandomNumberGenerator&& g);
601f9d540b0SHoward Hinnant
6023fbd3eafSArthur O'Dwyertemplate<class ForwardIterator>
6033fbd3eafSArthur O'Dwyer  constexpr ForwardIterator
6043fbd3eafSArthur O'Dwyer    shift_left(ForwardIterator first, ForwardIterator last,
6053fbd3eafSArthur O'Dwyer               typename iterator_traits<ForwardIterator>::difference_type n); // C++20
6063fbd3eafSArthur O'Dwyer
6073fbd3eafSArthur O'Dwyertemplate<class ForwardIterator>
6083fbd3eafSArthur O'Dwyer  constexpr ForwardIterator
6093fbd3eafSArthur O'Dwyer    shift_right(ForwardIterator first, ForwardIterator last,
6103fbd3eafSArthur O'Dwyer                typename iterator_traits<ForwardIterator>::difference_type n); // C++20
6113fbd3eafSArthur O'Dwyer
6123e519524SHoward Hinnanttemplate <class InputIterator, class Predicate>
61349c7643cSMarshall Clow    constexpr bool  // constexpr in C++20
6143e519524SHoward Hinnant    is_partitioned(InputIterator first, InputIterator last, Predicate pred);
6153e519524SHoward Hinnant
6163e519524SHoward Hinnanttemplate <class ForwardIterator, class Predicate>
617f851db3dSArthur O'Dwyer    constexpr ForwardIterator  // constexpr in C++20
6183e519524SHoward Hinnant    partition(ForwardIterator first, ForwardIterator last, Predicate pred);
6193e519524SHoward Hinnant
6203e519524SHoward Hinnanttemplate <class InputIterator, class OutputIterator1,
6213e519524SHoward Hinnant          class OutputIterator2, class Predicate>
6221b9a4ffdSMarshall Clow    constexpr pair<OutputIterator1, OutputIterator2>   // constexpr in C++20
6233e519524SHoward Hinnant    partition_copy(InputIterator first, InputIterator last,
6243e519524SHoward Hinnant                   OutputIterator1 out_true, OutputIterator2 out_false,
6253e519524SHoward Hinnant                   Predicate pred);
6263e519524SHoward Hinnant
6273e519524SHoward Hinnanttemplate <class ForwardIterator, class Predicate>
6283e519524SHoward Hinnant    ForwardIterator
6293e519524SHoward Hinnant    stable_partition(ForwardIterator first, ForwardIterator last, Predicate pred);
6303e519524SHoward Hinnant
6313e519524SHoward Hinnanttemplate<class ForwardIterator, class Predicate>
632d57c03ddSMarshall Clow    constexpr ForwardIterator  // constexpr in C++20
6333e519524SHoward Hinnant    partition_point(ForwardIterator first, ForwardIterator last, Predicate pred);
6343e519524SHoward Hinnant
6353e519524SHoward Hinnanttemplate <class ForwardIterator>
63649c7643cSMarshall Clow    constexpr bool  // constexpr in C++20
6373e519524SHoward Hinnant    is_sorted(ForwardIterator first, ForwardIterator last);
6383e519524SHoward Hinnant
6393e519524SHoward Hinnanttemplate <class ForwardIterator, class Compare>
640b8bc4e15SArthur O'Dwyer    constexpr bool  // constexpr in C++20
6413e519524SHoward Hinnant    is_sorted(ForwardIterator first, ForwardIterator last, Compare comp);
6423e519524SHoward Hinnant
6433e519524SHoward Hinnanttemplate<class ForwardIterator>
644056f15e3SMarshall Clow    constexpr ForwardIterator    // constexpr in C++20
6453e519524SHoward Hinnant    is_sorted_until(ForwardIterator first, ForwardIterator last);
6463e519524SHoward Hinnant
6473e519524SHoward Hinnanttemplate <class ForwardIterator, class Compare>
648056f15e3SMarshall Clow    constexpr ForwardIterator    // constexpr in C++20
6493e519524SHoward Hinnant    is_sorted_until(ForwardIterator first, ForwardIterator last, Compare comp);
6503e519524SHoward Hinnant
6513e519524SHoward Hinnanttemplate <class RandomAccessIterator>
652493f1407SArthur O'Dwyer    constexpr void               // constexpr in C++20
6533e519524SHoward Hinnant    sort(RandomAccessIterator first, RandomAccessIterator last);
6543e519524SHoward Hinnant
6553e519524SHoward Hinnanttemplate <class RandomAccessIterator, class Compare>
656493f1407SArthur O'Dwyer    constexpr void               // constexpr in C++20
6573e519524SHoward Hinnant    sort(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
6583e519524SHoward Hinnant
6593e519524SHoward Hinnanttemplate <class RandomAccessIterator>
6603e519524SHoward Hinnant    void
6613e519524SHoward Hinnant    stable_sort(RandomAccessIterator first, RandomAccessIterator last);
6623e519524SHoward Hinnant
6633e519524SHoward Hinnanttemplate <class RandomAccessIterator, class Compare>
6643e519524SHoward Hinnant    void
6653e519524SHoward Hinnant    stable_sort(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
6663e519524SHoward Hinnant
6673e519524SHoward Hinnanttemplate <class RandomAccessIterator>
6685386aa26SArthur O'Dwyer    constexpr void                    // constexpr in C++20
6693e519524SHoward Hinnant    partial_sort(RandomAccessIterator first, RandomAccessIterator middle, RandomAccessIterator last);
6703e519524SHoward Hinnant
6713e519524SHoward Hinnanttemplate <class RandomAccessIterator, class Compare>
6725386aa26SArthur O'Dwyer    constexpr void                    // constexpr in C++20
6733e519524SHoward Hinnant    partial_sort(RandomAccessIterator first, RandomAccessIterator middle, RandomAccessIterator last, Compare comp);
6743e519524SHoward Hinnant
6753e519524SHoward Hinnanttemplate <class InputIterator, class RandomAccessIterator>
6765386aa26SArthur O'Dwyer    constexpr RandomAccessIterator    // constexpr in C++20
6773e519524SHoward Hinnant    partial_sort_copy(InputIterator first, InputIterator last,
6783e519524SHoward Hinnant                      RandomAccessIterator result_first, RandomAccessIterator result_last);
6793e519524SHoward Hinnant
6803e519524SHoward Hinnanttemplate <class InputIterator, class RandomAccessIterator, class Compare>
6815386aa26SArthur O'Dwyer    constexpr RandomAccessIterator    // constexpr in C++20
6823e519524SHoward Hinnant    partial_sort_copy(InputIterator first, InputIterator last,
6833e519524SHoward Hinnant                      RandomAccessIterator result_first, RandomAccessIterator result_last, Compare comp);
6843e519524SHoward Hinnant
6853e519524SHoward Hinnanttemplate <class RandomAccessIterator>
6865d956563SArthur O'Dwyer    constexpr void                    // constexpr in C++20
6873e519524SHoward Hinnant    nth_element(RandomAccessIterator first, RandomAccessIterator nth, RandomAccessIterator last);
6883e519524SHoward Hinnant
6893e519524SHoward Hinnanttemplate <class RandomAccessIterator, class Compare>
6905d956563SArthur O'Dwyer    constexpr void                    // constexpr in C++20
6913e519524SHoward Hinnant    nth_element(RandomAccessIterator first, RandomAccessIterator nth, RandomAccessIterator last, Compare comp);
6923e519524SHoward Hinnant
6933e519524SHoward Hinnanttemplate <class ForwardIterator, class T>
694d57c03ddSMarshall Clow    constexpr ForwardIterator                         // constexpr in C++20
6953e519524SHoward Hinnant    lower_bound(ForwardIterator first, ForwardIterator last, const T& value);
6963e519524SHoward Hinnant
6973e519524SHoward Hinnanttemplate <class ForwardIterator, class T, class Compare>
698d57c03ddSMarshall Clow    constexpr ForwardIterator                         // constexpr in C++20
6993e519524SHoward Hinnant    lower_bound(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
7003e519524SHoward Hinnant
7013e519524SHoward Hinnanttemplate <class ForwardIterator, class T>
702d57c03ddSMarshall Clow    constexpr ForwardIterator                         // constexpr in C++20
7033e519524SHoward Hinnant    upper_bound(ForwardIterator first, ForwardIterator last, const T& value);
7043e519524SHoward Hinnant
7053e519524SHoward Hinnanttemplate <class ForwardIterator, class T, class Compare>
706d57c03ddSMarshall Clow    constexpr ForwardIterator                         // constexpr in C++20
7073e519524SHoward Hinnant    upper_bound(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
7083e519524SHoward Hinnant
7093e519524SHoward Hinnanttemplate <class ForwardIterator, class T>
710d57c03ddSMarshall Clow    constexpr pair<ForwardIterator, ForwardIterator>  // constexpr in C++20
7113e519524SHoward Hinnant    equal_range(ForwardIterator first, ForwardIterator last, const T& value);
7123e519524SHoward Hinnant
7133e519524SHoward Hinnanttemplate <class ForwardIterator, class T, class Compare>
714d57c03ddSMarshall Clow    constexpr pair<ForwardIterator, ForwardIterator>  // constexpr in C++20
7153e519524SHoward Hinnant    equal_range(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
7163e519524SHoward Hinnant
7173e519524SHoward Hinnanttemplate <class ForwardIterator, class T>
718d57c03ddSMarshall Clow    constexpr bool                                    // constexpr in C++20
7193e519524SHoward Hinnant    binary_search(ForwardIterator first, ForwardIterator last, const T& value);
7203e519524SHoward Hinnant
7213e519524SHoward Hinnanttemplate <class ForwardIterator, class T, class Compare>
7228da1a487SMarshall Clow    constexpr bool                                    // constexpr in C++20
7233e519524SHoward Hinnant    binary_search(ForwardIterator first, ForwardIterator last, const T& value, Compare comp);
7243e519524SHoward Hinnant
7253e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2, class OutputIterator>
72614098cf6SArthur O'Dwyer    constexpr OutputIterator                          // constexpr in C++20
7273e519524SHoward Hinnant    merge(InputIterator1 first1, InputIterator1 last1,
7283e519524SHoward Hinnant          InputIterator2 first2, InputIterator2 last2, OutputIterator result);
7293e519524SHoward Hinnant
7303e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
73114098cf6SArthur O'Dwyer    constexpr OutputIterator                          // constexpr in C++20
7323e519524SHoward Hinnant    merge(InputIterator1 first1, InputIterator1 last1,
7333e519524SHoward Hinnant          InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
7343e519524SHoward Hinnant
7353e519524SHoward Hinnanttemplate <class BidirectionalIterator>
7363e519524SHoward Hinnant    void
7373e519524SHoward Hinnant    inplace_merge(BidirectionalIterator first, BidirectionalIterator middle, BidirectionalIterator last);
7383e519524SHoward Hinnant
7393e519524SHoward Hinnanttemplate <class BidirectionalIterator, class Compare>
7403e519524SHoward Hinnant    void
7413e519524SHoward Hinnant    inplace_merge(BidirectionalIterator first, BidirectionalIterator middle, BidirectionalIterator last, Compare comp);
7423e519524SHoward Hinnant
7433e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2>
7448da1a487SMarshall Clow    constexpr bool                                    // constexpr in C++20
7453e519524SHoward Hinnant    includes(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2);
7463e519524SHoward Hinnant
7473e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2, class Compare>
7488da1a487SMarshall Clow    constexpr bool                                    // constexpr in C++20
7493e519524SHoward Hinnant    includes(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2, Compare comp);
7503e519524SHoward Hinnant
7513e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2, class OutputIterator>
75214098cf6SArthur O'Dwyer    constexpr OutputIterator                          // constexpr in C++20
7533e519524SHoward Hinnant    set_union(InputIterator1 first1, InputIterator1 last1,
7543e519524SHoward Hinnant              InputIterator2 first2, InputIterator2 last2, OutputIterator result);
7553e519524SHoward Hinnant
7563e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
75714098cf6SArthur O'Dwyer    constexpr OutputIterator                          // constexpr in C++20
7583e519524SHoward Hinnant    set_union(InputIterator1 first1, InputIterator1 last1,
7593e519524SHoward Hinnant              InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
7603e519524SHoward Hinnant
7613e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2, class OutputIterator>
7628da1a487SMarshall Clow    constexpr OutputIterator                         // constexpr in C++20
7633e519524SHoward Hinnant    set_intersection(InputIterator1 first1, InputIterator1 last1,
7643e519524SHoward Hinnant                     InputIterator2 first2, InputIterator2 last2, OutputIterator result);
7653e519524SHoward Hinnant
7663e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
7678da1a487SMarshall Clow    constexpr OutputIterator                         // constexpr in C++20
7683e519524SHoward Hinnant    set_intersection(InputIterator1 first1, InputIterator1 last1,
7693e519524SHoward Hinnant                     InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
7703e519524SHoward Hinnant
7713e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2, class OutputIterator>
77214098cf6SArthur O'Dwyer    constexpr OutputIterator                         // constexpr in C++20
7733e519524SHoward Hinnant    set_difference(InputIterator1 first1, InputIterator1 last1,
7743e519524SHoward Hinnant                   InputIterator2 first2, InputIterator2 last2, OutputIterator result);
7753e519524SHoward Hinnant
7763e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
77714098cf6SArthur O'Dwyer    constexpr OutputIterator                         // constexpr in C++20
7783e519524SHoward Hinnant    set_difference(InputIterator1 first1, InputIterator1 last1,
7793e519524SHoward Hinnant                   InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
7803e519524SHoward Hinnant
7813e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2, class OutputIterator>
78214098cf6SArthur O'Dwyer    constexpr OutputIterator                         // constexpr in C++20
7833e519524SHoward Hinnant    set_symmetric_difference(InputIterator1 first1, InputIterator1 last1,
7843e519524SHoward Hinnant                             InputIterator2 first2, InputIterator2 last2, OutputIterator result);
7853e519524SHoward Hinnant
7863e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2, class OutputIterator, class Compare>
78714098cf6SArthur O'Dwyer    constexpr OutputIterator                         // constexpr in C++20
7883e519524SHoward Hinnant    set_symmetric_difference(InputIterator1 first1, InputIterator1 last1,
7893e519524SHoward Hinnant                             InputIterator2 first2, InputIterator2 last2, OutputIterator result, Compare comp);
7903e519524SHoward Hinnant
7913e519524SHoward Hinnanttemplate <class RandomAccessIterator>
7925386aa26SArthur O'Dwyer    constexpr void                                   // constexpr in C++20
7933e519524SHoward Hinnant    push_heap(RandomAccessIterator first, RandomAccessIterator last);
7943e519524SHoward Hinnant
7953e519524SHoward Hinnanttemplate <class RandomAccessIterator, class Compare>
7965386aa26SArthur O'Dwyer    constexpr void                                   // constexpr in C++20
7973e519524SHoward Hinnant    push_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
7983e519524SHoward Hinnant
7993e519524SHoward Hinnanttemplate <class RandomAccessIterator>
8005386aa26SArthur O'Dwyer    constexpr void                                   // constexpr in C++20
8013e519524SHoward Hinnant    pop_heap(RandomAccessIterator first, RandomAccessIterator last);
8023e519524SHoward Hinnant
8033e519524SHoward Hinnanttemplate <class RandomAccessIterator, class Compare>
8045386aa26SArthur O'Dwyer    constexpr void                                   // constexpr in C++20
8053e519524SHoward Hinnant    pop_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
8063e519524SHoward Hinnant
8073e519524SHoward Hinnanttemplate <class RandomAccessIterator>
8085386aa26SArthur O'Dwyer    constexpr void                                   // constexpr in C++20
8093e519524SHoward Hinnant    make_heap(RandomAccessIterator first, RandomAccessIterator last);
8103e519524SHoward Hinnant
8113e519524SHoward Hinnanttemplate <class RandomAccessIterator, class Compare>
8125386aa26SArthur O'Dwyer    constexpr void                                   // constexpr in C++20
8133e519524SHoward Hinnant    make_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
8143e519524SHoward Hinnant
8153e519524SHoward Hinnanttemplate <class RandomAccessIterator>
8165386aa26SArthur O'Dwyer    constexpr void                                   // constexpr in C++20
8173e519524SHoward Hinnant    sort_heap(RandomAccessIterator first, RandomAccessIterator last);
8183e519524SHoward Hinnant
8193e519524SHoward Hinnanttemplate <class RandomAccessIterator, class Compare>
8205386aa26SArthur O'Dwyer    constexpr void                                   // constexpr in C++20
8213e519524SHoward Hinnant    sort_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp);
8223e519524SHoward Hinnant
8233e519524SHoward Hinnanttemplate <class RandomAccessIterator>
82449c7643cSMarshall Clow    constexpr bool   // constexpr in C++20
8253e519524SHoward Hinnant    is_heap(RandomAccessIterator first, RandomAccessiterator last);
8263e519524SHoward Hinnant
8273e519524SHoward Hinnanttemplate <class RandomAccessIterator, class Compare>
82849c7643cSMarshall Clow    constexpr bool   // constexpr in C++20
8293e519524SHoward Hinnant    is_heap(RandomAccessIterator first, RandomAccessiterator last, Compare comp);
8303e519524SHoward Hinnant
8313e519524SHoward Hinnanttemplate <class RandomAccessIterator>
83249c7643cSMarshall Clow    constexpr RandomAccessIterator   // constexpr in C++20
8333e519524SHoward Hinnant    is_heap_until(RandomAccessIterator first, RandomAccessiterator last);
8343e519524SHoward Hinnant
8353e519524SHoward Hinnanttemplate <class RandomAccessIterator, class Compare>
83649c7643cSMarshall Clow    constexpr RandomAccessIterator   // constexpr in C++20
8373e519524SHoward Hinnant    is_heap_until(RandomAccessIterator first, RandomAccessiterator last, Compare comp);
8383e519524SHoward Hinnant
8394eb27b79SHoward Hinnanttemplate <class ForwardIterator>
840b8bc4e15SArthur O'Dwyer    constexpr ForwardIterator        // constexpr in C++14
841b8bc4e15SArthur O'Dwyer    min_element(ForwardIterator first, ForwardIterator last);
8424eb27b79SHoward Hinnant
8434eb27b79SHoward Hinnanttemplate <class ForwardIterator, class Compare>
844b8bc4e15SArthur O'Dwyer    constexpr ForwardIterator        // constexpr in C++14
845b8bc4e15SArthur O'Dwyer    min_element(ForwardIterator first, ForwardIterator last, Compare comp);
8464eb27b79SHoward Hinnant
8473e519524SHoward Hinnanttemplate <class T>
848b8bc4e15SArthur O'Dwyer    constexpr const T&               // constexpr in C++14
849b8bc4e15SArthur O'Dwyer    min(const T& a, const T& b);
8503e519524SHoward Hinnant
8513e519524SHoward Hinnanttemplate <class T, class Compare>
852b8bc4e15SArthur O'Dwyer    constexpr const T&               // constexpr in C++14
853b8bc4e15SArthur O'Dwyer    min(const T& a, const T& b, Compare comp);
8543e519524SHoward Hinnant
8553e519524SHoward Hinnanttemplate<class T>
856b8bc4e15SArthur O'Dwyer    constexpr T                      // constexpr in C++14
857b8bc4e15SArthur O'Dwyer    min(initializer_list<T> t);
8583e519524SHoward Hinnant
8593e519524SHoward Hinnanttemplate<class T, class Compare>
860b8bc4e15SArthur O'Dwyer    constexpr T                      // constexpr in C++14
861b8bc4e15SArthur O'Dwyer    min(initializer_list<T> t, Compare comp);
8623e519524SHoward Hinnant
863146c14acSMarshall Clowtemplate<class T>
864146c14acSMarshall Clow    constexpr const T& clamp(const T& v, const T& lo, const T& hi);               // C++17
865146c14acSMarshall Clow
866146c14acSMarshall Clowtemplate<class T, class Compare>
867146c14acSMarshall Clow    constexpr const T& clamp(const T& v, const T& lo, const T& hi, Compare comp); // C++17
868146c14acSMarshall Clow
8693e519524SHoward Hinnanttemplate <class ForwardIterator>
870b8bc4e15SArthur O'Dwyer    constexpr ForwardIterator        // constexpr in C++14
871b8bc4e15SArthur O'Dwyer    max_element(ForwardIterator first, ForwardIterator last);
8723e519524SHoward Hinnant
8733e519524SHoward Hinnanttemplate <class ForwardIterator, class Compare>
874b8bc4e15SArthur O'Dwyer    constexpr ForwardIterator        // constexpr in C++14
875b8bc4e15SArthur O'Dwyer    max_element(ForwardIterator first, ForwardIterator last, Compare comp);
8763e519524SHoward Hinnant
8774eb27b79SHoward Hinnanttemplate <class T>
878b8bc4e15SArthur O'Dwyer    constexpr const T&               // constexpr in C++14
879b8bc4e15SArthur O'Dwyer    max(const T& a, const T& b);
8804eb27b79SHoward Hinnant
8814eb27b79SHoward Hinnanttemplate <class T, class Compare>
882b8bc4e15SArthur O'Dwyer    constexpr const T&               // constexpr in C++14
883b8bc4e15SArthur O'Dwyer    max(const T& a, const T& b, Compare comp);
8844eb27b79SHoward Hinnant
8854eb27b79SHoward Hinnanttemplate<class T>
886b8bc4e15SArthur O'Dwyer    constexpr T                      // constexpr in C++14
887b8bc4e15SArthur O'Dwyer    max(initializer_list<T> t);
8884eb27b79SHoward Hinnant
8894eb27b79SHoward Hinnanttemplate<class T, class Compare>
890b8bc4e15SArthur O'Dwyer    constexpr T                      // constexpr in C++14
891b8bc4e15SArthur O'Dwyer    max(initializer_list<T> t, Compare comp);
8924eb27b79SHoward Hinnant
8934eb27b79SHoward Hinnanttemplate<class ForwardIterator>
894b8bc4e15SArthur O'Dwyer    constexpr pair<ForwardIterator, ForwardIterator>  // constexpr in C++14
895b8bc4e15SArthur O'Dwyer    minmax_element(ForwardIterator first, ForwardIterator last);
8964eb27b79SHoward Hinnant
8974eb27b79SHoward Hinnanttemplate<class ForwardIterator, class Compare>
898b8bc4e15SArthur O'Dwyer    constexpr pair<ForwardIterator, ForwardIterator>  // constexpr in C++14
899b8bc4e15SArthur O'Dwyer    minmax_element(ForwardIterator first, ForwardIterator last, Compare comp);
9004eb27b79SHoward Hinnant
9014eb27b79SHoward Hinnanttemplate<class T>
902b8bc4e15SArthur O'Dwyer    constexpr pair<const T&, const T&>  // constexpr in C++14
903b8bc4e15SArthur O'Dwyer    minmax(const T& a, const T& b);
9044eb27b79SHoward Hinnant
9054eb27b79SHoward Hinnanttemplate<class T, class Compare>
906b8bc4e15SArthur O'Dwyer    constexpr pair<const T&, const T&>  // constexpr in C++14
907b8bc4e15SArthur O'Dwyer    minmax(const T& a, const T& b, Compare comp);
9084eb27b79SHoward Hinnant
9094eb27b79SHoward Hinnanttemplate<class T>
910b8bc4e15SArthur O'Dwyer    constexpr pair<T, T>                // constexpr in C++14
911b8bc4e15SArthur O'Dwyer    minmax(initializer_list<T> t);
9124eb27b79SHoward Hinnant
9134eb27b79SHoward Hinnanttemplate<class T, class Compare>
914b8bc4e15SArthur O'Dwyer    constexpr pair<T, T>                // constexpr in C++14
915b8bc4e15SArthur O'Dwyer    minmax(initializer_list<T> t, Compare comp);
9164eb27b79SHoward Hinnant
9173e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2>
9181b9a4ffdSMarshall Clow    constexpr bool     // constexpr in C++20
9193e519524SHoward Hinnant    lexicographical_compare(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2);
9203e519524SHoward Hinnant
9213e519524SHoward Hinnanttemplate <class InputIterator1, class InputIterator2, class Compare>
9221b9a4ffdSMarshall Clow    constexpr bool     // constexpr in C++20
9233e519524SHoward Hinnant    lexicographical_compare(InputIterator1 first1, InputIterator1 last1,
9243e519524SHoward Hinnant                            InputIterator2 first2, InputIterator2 last2, Compare comp);
9253e519524SHoward Hinnant
9263e519524SHoward Hinnanttemplate <class BidirectionalIterator>
927f851db3dSArthur O'Dwyer    constexpr bool     // constexpr in C++20
9283e519524SHoward Hinnant    next_permutation(BidirectionalIterator first, BidirectionalIterator last);
9293e519524SHoward Hinnant
9303e519524SHoward Hinnanttemplate <class BidirectionalIterator, class Compare>
931f851db3dSArthur O'Dwyer    constexpr bool     // constexpr in C++20
9323e519524SHoward Hinnant    next_permutation(BidirectionalIterator first, BidirectionalIterator last, Compare comp);
9333e519524SHoward Hinnant
9343e519524SHoward Hinnanttemplate <class BidirectionalIterator>
935f851db3dSArthur O'Dwyer    constexpr bool     // constexpr in C++20
9363e519524SHoward Hinnant    prev_permutation(BidirectionalIterator first, BidirectionalIterator last);
9373e519524SHoward Hinnant
9383e519524SHoward Hinnanttemplate <class BidirectionalIterator, class Compare>
939f851db3dSArthur O'Dwyer    constexpr bool     // constexpr in C++20
9403e519524SHoward Hinnant    prev_permutation(BidirectionalIterator first, BidirectionalIterator last, Compare comp);
9413e519524SHoward Hinnant}  // std
9423e519524SHoward Hinnant
9433e519524SHoward Hinnant*/
9443e519524SHoward Hinnant
945385cc25aSLouis Dionne#include <__assert> // all public C++ headers provide the assertion handler
946ea2206d7SArthur O'Dwyer#include <__bits>
9473e519524SHoward Hinnant#include <__config>
948134723edSLouis Dionne#include <__debug>
949a1d07d57SHoward Hinnant#include <cstddef>
950bfbd73f8SArthur O'Dwyer#include <cstring>
951bfbd73f8SArthur O'Dwyer#include <initializer_list>
952bfbd73f8SArthur O'Dwyer#include <iterator>
953bfbd73f8SArthur O'Dwyer#include <memory>
954bfbd73f8SArthur O'Dwyer#include <type_traits>
955f56972e2SMarshall Clow#include <version>
9565d1a701dSHoward Hinnant
957134723edSLouis Dionne#include <__algorithm/adjacent_find.h>
958134723edSLouis Dionne#include <__algorithm/all_of.h>
959134723edSLouis Dionne#include <__algorithm/any_of.h>
960134723edSLouis Dionne#include <__algorithm/binary_search.h>
961134723edSLouis Dionne#include <__algorithm/clamp.h>
962134723edSLouis Dionne#include <__algorithm/comp.h>
963134723edSLouis Dionne#include <__algorithm/comp_ref_type.h>
964134723edSLouis Dionne#include <__algorithm/copy.h>
965134723edSLouis Dionne#include <__algorithm/copy_backward.h>
966134723edSLouis Dionne#include <__algorithm/copy_if.h>
967134723edSLouis Dionne#include <__algorithm/copy_n.h>
968134723edSLouis Dionne#include <__algorithm/count.h>
969134723edSLouis Dionne#include <__algorithm/count_if.h>
970134723edSLouis Dionne#include <__algorithm/equal.h>
971134723edSLouis Dionne#include <__algorithm/equal_range.h>
972134723edSLouis Dionne#include <__algorithm/fill.h>
9734d81a46fSArthur O'Dwyer#include <__algorithm/fill_n.h>
974134723edSLouis Dionne#include <__algorithm/find.h>
975134723edSLouis Dionne#include <__algorithm/find_end.h>
976134723edSLouis Dionne#include <__algorithm/find_first_of.h>
977134723edSLouis Dionne#include <__algorithm/find_if.h>
978134723edSLouis Dionne#include <__algorithm/find_if_not.h>
979134723edSLouis Dionne#include <__algorithm/for_each.h>
980134723edSLouis Dionne#include <__algorithm/for_each_n.h>
981134723edSLouis Dionne#include <__algorithm/generate.h>
9824d81a46fSArthur O'Dwyer#include <__algorithm/generate_n.h>
983134723edSLouis Dionne#include <__algorithm/half_positive.h>
98468f4131cSNikolas Klauser#include <__algorithm/in_found_result.h>
9851e77b396SNikolas Klauser#include <__algorithm/in_fun_result.h>
986f3514af4SNikolas Klauser#include <__algorithm/in_in_out_result.h>
987d3729bb3SNikolas Klauser#include <__algorithm/in_in_result.h>
988610979b3SNikolas Klauser#include <__algorithm/in_out_out_result.h>
9898d23b742SKonstantin Varlamov#include <__algorithm/in_out_result.h>
990134723edSLouis Dionne#include <__algorithm/includes.h>
991134723edSLouis Dionne#include <__algorithm/inplace_merge.h>
992134723edSLouis Dionne#include <__algorithm/is_heap.h>
993134723edSLouis Dionne#include <__algorithm/is_heap_until.h>
994134723edSLouis Dionne#include <__algorithm/is_partitioned.h>
995134723edSLouis Dionne#include <__algorithm/is_permutation.h>
996134723edSLouis Dionne#include <__algorithm/is_sorted.h>
997134723edSLouis Dionne#include <__algorithm/is_sorted_until.h>
9986adbc83eSChristopher Di Bella#include <__algorithm/iter_swap.h>
999134723edSLouis Dionne#include <__algorithm/lexicographical_compare.h>
1000134723edSLouis Dionne#include <__algorithm/lower_bound.h>
1001134723edSLouis Dionne#include <__algorithm/make_heap.h>
1002134723edSLouis Dionne#include <__algorithm/max.h>
1003134723edSLouis Dionne#include <__algorithm/max_element.h>
1004134723edSLouis Dionne#include <__algorithm/merge.h>
1005134723edSLouis Dionne#include <__algorithm/min.h>
1006134723edSLouis Dionne#include <__algorithm/min_element.h>
1007807766beSNikolas Klauser#include <__algorithm/min_max_result.h>
1008134723edSLouis Dionne#include <__algorithm/minmax.h>
1009134723edSLouis Dionne#include <__algorithm/minmax_element.h>
1010134723edSLouis Dionne#include <__algorithm/mismatch.h>
1011134723edSLouis Dionne#include <__algorithm/move.h>
1012134723edSLouis Dionne#include <__algorithm/move_backward.h>
1013134723edSLouis Dionne#include <__algorithm/next_permutation.h>
1014134723edSLouis Dionne#include <__algorithm/none_of.h>
1015134723edSLouis Dionne#include <__algorithm/nth_element.h>
1016134723edSLouis Dionne#include <__algorithm/partial_sort.h>
1017134723edSLouis Dionne#include <__algorithm/partial_sort_copy.h>
1018134723edSLouis Dionne#include <__algorithm/partition.h>
1019134723edSLouis Dionne#include <__algorithm/partition_copy.h>
1020134723edSLouis Dionne#include <__algorithm/partition_point.h>
1021134723edSLouis Dionne#include <__algorithm/pop_heap.h>
1022134723edSLouis Dionne#include <__algorithm/prev_permutation.h>
1023134723edSLouis Dionne#include <__algorithm/push_heap.h>
10241d83750fSNikolas Klauser#include <__algorithm/ranges_copy.h>
10251d83750fSNikolas Klauser#include <__algorithm/ranges_copy_backward.h>
10261d83750fSNikolas Klauser#include <__algorithm/ranges_copy_if.h>
10271d83750fSNikolas Klauser#include <__algorithm/ranges_copy_n.h>
10281306b102SNikolas Klauser#include <__algorithm/ranges_count.h>
10291306b102SNikolas Klauser#include <__algorithm/ranges_count_if.h>
1030*569d6630SNikolas Klauser#include <__algorithm/ranges_equal.h>
10317af89a37SNikolas Klauser#include <__algorithm/ranges_fill.h>
10327af89a37SNikolas Klauser#include <__algorithm/ranges_fill_n.h>
1033ee0f8c40SNikolas Klauser#include <__algorithm/ranges_find.h>
1034ee0f8c40SNikolas Klauser#include <__algorithm/ranges_find_if.h>
1035ee0f8c40SNikolas Klauser#include <__algorithm/ranges_find_if_not.h>
103680045e9aSNikolas Klauser#include <__algorithm/ranges_for_each.h>
103780045e9aSNikolas Klauser#include <__algorithm/ranges_for_each_n.h>
103837ba1b9dSNikolas Klauser#include <__algorithm/ranges_is_partitioned.h>
1039e476df56SNikolas Klauser#include <__algorithm/ranges_max.h>
1040205557c9SNikolas Klauser#include <__algorithm/ranges_max_element.h>
1041f83d833eSNikolas Klauser#include <__algorithm/ranges_min.h>
10423b470d1cSNikolas Klauser#include <__algorithm/ranges_min_element.h>
104358d9ab70SNikolas Klauser#include <__algorithm/ranges_minmax.h>
104458d9ab70SNikolas Klauser#include <__algorithm/ranges_minmax_element.h>
1045c2cd15a6SNikolas Klauser#include <__algorithm/ranges_mismatch.h>
10461d1a191eSNikolas Klauser#include <__algorithm/ranges_reverse.h>
10479d905319SNikolas Klauser#include <__algorithm/ranges_swap_ranges.h>
10483ba8548cSNikolas Klauser#include <__algorithm/ranges_transform.h>
1049134723edSLouis Dionne#include <__algorithm/remove.h>
1050134723edSLouis Dionne#include <__algorithm/remove_copy.h>
1051134723edSLouis Dionne#include <__algorithm/remove_copy_if.h>
1052134723edSLouis Dionne#include <__algorithm/remove_if.h>
1053134723edSLouis Dionne#include <__algorithm/replace.h>
1054134723edSLouis Dionne#include <__algorithm/replace_copy.h>
1055134723edSLouis Dionne#include <__algorithm/replace_copy_if.h>
1056134723edSLouis Dionne#include <__algorithm/replace_if.h>
1057134723edSLouis Dionne#include <__algorithm/reverse.h>
1058134723edSLouis Dionne#include <__algorithm/reverse_copy.h>
1059134723edSLouis Dionne#include <__algorithm/rotate.h>
1060134723edSLouis Dionne#include <__algorithm/rotate_copy.h>
1061134723edSLouis Dionne#include <__algorithm/sample.h>
1062134723edSLouis Dionne#include <__algorithm/search.h>
1063134723edSLouis Dionne#include <__algorithm/search_n.h>
1064134723edSLouis Dionne#include <__algorithm/set_difference.h>
1065134723edSLouis Dionne#include <__algorithm/set_intersection.h>
1066134723edSLouis Dionne#include <__algorithm/set_symmetric_difference.h>
1067134723edSLouis Dionne#include <__algorithm/set_union.h>
1068134723edSLouis Dionne#include <__algorithm/shift_left.h>
1069134723edSLouis Dionne#include <__algorithm/shift_right.h>
1070134723edSLouis Dionne#include <__algorithm/shuffle.h>
1071134723edSLouis Dionne#include <__algorithm/sift_down.h>
1072134723edSLouis Dionne#include <__algorithm/sort.h>
1073134723edSLouis Dionne#include <__algorithm/sort_heap.h>
1074134723edSLouis Dionne#include <__algorithm/stable_partition.h>
1075134723edSLouis Dionne#include <__algorithm/stable_sort.h>
10766adbc83eSChristopher Di Bella#include <__algorithm/swap_ranges.h>
1077134723edSLouis Dionne#include <__algorithm/transform.h>
1078134723edSLouis Dionne#include <__algorithm/unique.h>
10794d81a46fSArthur O'Dwyer#include <__algorithm/unique_copy.h>
1080134723edSLouis Dionne#include <__algorithm/unwrap_iter.h>
1081134723edSLouis Dionne#include <__algorithm/upper_bound.h>
1082c1bd9197SEric Fiselier
1083073458b1SHoward Hinnant#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
10843e519524SHoward Hinnant#  pragma GCC system_header
1085073458b1SHoward Hinnant#endif
10863e519524SHoward Hinnant
10870a06eb91SLouis Dionne#if defined(_LIBCPP_HAS_PARALLEL_ALGORITHMS) && _LIBCPP_STD_VER >= 17
108895689243SLouis Dionne#   include <__pstl_algorithm>
10890a06eb91SLouis Dionne#endif
10900a06eb91SLouis Dionne
10913e519524SHoward Hinnant#endif // _LIBCPP_ALGORITHM
1092