Namespaces
Variants

std::ranges:: max

From cppreference.net
Algorithm library
Constrained algorithms and algorithms on ranges (C++20)
Constrained algorithms, e.g. ranges::copy , ranges::sort , ...
Execution policies (C++17)
Non-modifying sequence operations
Batch operations
(C++17)
Search operations
Modifying sequence operations
Copy operations
(C++11)
(C++11)
Swap operations
Transformation operations
Generation operations
Removing operations
Order-changing operations
(until C++17) (C++11)
(C++20) (C++20)
Sampling operations
(C++17)

Sorting and related operations
Partitioning operations
Sorting operations
Binary search operations
(on partitioned ranges)
Set operations (on sorted ranges)
Merge operations (on sorted ranges)
Heap operations
Minimum/maximum operations
Lexicographical comparison operations
Permutation operations
C library
Numeric operations
Operations on uninitialized memory
Constrained algorithms
All names in this menu belong to namespace std::ranges
Non-modifying sequence operations
Modifying sequence operations
Partitioning operations
Sorting operations
Binary search operations (on sorted ranges)
Set operations (on sorted ranges)
Heap operations
Minimum/maximum operations
Permutation operations
Fold operations
Operations on uninitialized storage
Return types
(Anmerkung: Der bereitgestellte HTML-Code enthält keinen übersetzbaren Text, da alle Tags und Attribute unverändert bleiben müssen und die Zelleninhalte leer sind. Daher bleibt die Ausgabe identisch mit der Eingabe.)
Definiert in Header <algorithm>
Aufrufsignatur
template < class T, class Proj = std:: identity ,

std:: indirect_strict_weak_order <
std :: projected < const T * , Proj >> Comp = ranges:: less >
constexpr const T &

max ( const T & a, const T & b, Comp comp = { } , Proj proj = { } ) ;
(1) (seit C++20)
template < std:: copyable T, class Proj = std:: identity ,

std:: indirect_strict_weak_order <
std :: projected < const T * , Proj >> Comp = ranges:: less >
constexpr T

max ( std:: initializer_list < T > r, Comp comp = { } , Proj proj = { } ) ;
(2) (seit C++20)
template < ranges:: input_range R, class Proj = std:: identity ,

std:: indirect_strict_weak_order <
std :: projected < ranges:: iterator_t < R > , Proj >> Comp = ranges:: less >
erfordert std:: indirectly_copyable_storable < ranges:: iterator_t < R > ,
ranges:: range_value_t < R > * >
constexpr ranges:: range_value_t < R >

max ( R && r, Comp comp = { } , Proj proj = { } ) ;
(3) (seit C++20)

Gibt den größeren der gegebenen projizierten Werte zurück.

1) Gibt den größeren Wert von a und b zurück.
2) Gibt den ersten größten Wert in der Initialisierungsliste r zurück.
3) Gibt den ersten größten Wert im Bereich r zurück.

Die auf dieser Seite beschriebenen funktionsähnlichen Entitäten sind Algorithm Function Objects (informell bekannt als Niebloids ), das heißt:

Inhaltsverzeichnis

Parameter

a, b - die zu vergleichenden Werte
r - der Bereich der zu vergleichenden Werte
comp - Vergleich, der auf die projizierten Elemente angewendet wird
proj - Projektion, die auf die Elemente angewendet wird

Rückgabewert

1) Der größere Wert von a und b , gemäß ihrer jeweiligen projizierten Werte. Wenn sie äquivalent sind, wird a zurückgegeben.
2,3) Der größte Wert in r , gemäß der Projektion. Wenn mehrere Werte gleich dem größten sind, wird der am weitesten links stehende zurückgegeben. Wenn der Bereich leer ist (bestimmt durch ranges:: distance ( r ) ), ist das Verhalten undefiniert.

Komplexität

1) Genau ein Vergleich.
2,3) Genau ranges:: distance ( r ) - 1 Vergleiche.

Mögliche Implementierung

struct max_fn
{
    template<class T, class Proj = std::identity,
             std::indirect_strict_weak_order<
                 std::projected<const T*, Proj>> Comp = ranges::less>
    constexpr
    const T& operator()(const T& a, const T& b, Comp comp = {}, Proj proj = {}) const
    {
        return std::invoke(comp, std::invoke(proj, a), std::invoke(proj, b)) ? b : a;
    }
    template<std::copyable T, class Proj = std::identity,
             std::indirect_strict_weak_order<
                 std::projected<const T*, Proj>> Comp = ranges::less>
    constexpr
    T operator()(std::initializer_list<T> r, Comp comp = {}, Proj proj = {}) const
    {
        return *ranges::max_element(r, std::ref(comp), std::ref(proj));
    }
    template<ranges::input_range R, class Proj = std::identity,
             std::indirect_strict_weak_order<
                  std::projected<ranges::iterator_t<R>, Proj>> Comp = ranges::less>
    requires std::indirectly_copyable_storable<ranges::iterator_t<R>,
                                               ranges::range_value_t<R>*>
    constexpr
    ranges::range_value_t<R> operator()(R&& r, Comp comp = {}, Proj proj = {}) const
    {
        using V = ranges::range_value_t<R>;
        if constexpr (ranges::forward_range<R>)
            return
                static_cast<V>(*ranges::max_element(r, std::ref(comp), std::ref(proj)));
        else
        {
            auto i = ranges::begin(r);
            auto s = ranges::end(r);
            V m(*i);
            while (++i != s)
                if (std::invoke(comp, std::invoke(proj, m), std::invoke(proj, *i)))
                    m = *i;
            return m;
        }
    }
};
inline constexpr max_fn max;

Hinweise

Das Erfassen des Ergebnisses von std::ranges::max per Referenz erzeugt eine hängende Referenz, wenn einer der Parameter ein temporäres Objekt ist und dieser Parameter zurückgegeben wird:

int n = -1;
const int& r = std::ranges::max(n + 2, n * 2); // r ist hängend

Beispiel

#include <algorithm>
#include <iostream>
#include <string>
static_assert(std::ranges::max({0B10, 0X10, 010, 10}) == 16); // overload (2)
int main()
{
    namespace ranges = std::ranges;
    using namespace std::string_view_literals;
    std::cout << "larger of 1 and 9999: " << ranges::max(1, 9999) << '\n'
              << "larger of 'a', and 'b': '" << ranges::max('a', 'b') << "'\n"
              << "longest of \"foo\", \"bar\", and \"hello\": \""
              << ranges::max({"foo"sv, "bar"sv, "hello"sv}, {},
                             &std::string_view::size) << "\"\n";
}

Ausgabe:

larger of 1 and 9999: 9999
larger of 'a', and 'b': 'b'
longest of "foo", "bar", and "hello": "hello"

Siehe auch

gibt den kleineren der gegebenen Werte zurück
(Algorithmus-Funktionsobjekt)
gibt den kleineren und größeren von zwei Elementen zurück
(Algorithmus-Funktionsobjekt)
gibt das größte Element in einem Bereich zurück
(Algorithmus-Funktionsobjekt)
begrenzt einen Wert zwischen einem Paar von Grenzwerten
(Algorithmus-Funktionsobjekt)
gibt den größeren der gegebenen Werte zurück
(Funktionstemplate)