WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::min — den kleinsten Wert auswählen

std::min aus <algorithm> wählt das kleinere von zwei Argumenten oder das Minimum einer nicht leeren Liste aus. Die Zwei-Argumente-Überladung gibt eine Referenz zurück, die Listen-Überladung eine Kopie; ein optionaler Komparator legt die Reihenfolge fest.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <algorithm>

std::min(a, b)
std::min(a, b, comp)
std::min({a, b, c})
std::min({a, b, c}, comp)

std::min benötigt <algorithm>. In C++23 verwenden die Überladungen ohne expliziten Komparator den Operator < statt std::less{}. Für Zeiger bieten sie daher nicht die von std::less garantierte strikte Totalordnung. Ein optionales comp muss eine strikte schwache Ordnung definieren. Äquivalenz bedeutet, dass in dieser Ordnung keines der Argumente vor dem anderen steht.

std::min(a, b) gibt const T& zurück, die auf das kleinere Argument verweist, bei Äquivalenz auf das erste. Es führt genau einen Vergleich aus. Für die Deduktion ist ein gemeinsames T erforderlich: std::min(1, 2.0) lässt sich nicht kompilieren; verwenden Sie übereinstimmende Typen oder explizit std::min<double>(1, 2.0).

std::min({a, b, c}) gibt eine Kopie des ersten Minimums als Wert zurück. Die Liste darf nicht leer sein, und T muss kopierkonstruierbar sein. Bei N Elementen werden genau N - 1 Vergleiche ausgeführt.

Achten Sie auf Lebensdauern: const int& r = std::min(1, 2); hinterlässt nach Ende der Anweisung eine ungültige Referenz. Wenn Sie das Ergebnis als int oder auto speichern, entsteht eine sichere Kopie. Im Beispiel verwendet comp >, daher ist das Minimum gemäß der umgekehrten Ordnung die größere Zahl.

Beispiele

#include <algorithm>
#include <iostream>

int main() {
    int a = 7;
    int b = 3;
    int pair_min = std::min(a, b);
    int list_min = std::min({7, 3, 5});
    int reverse_min = std::min(a, b, [](int x, int y) {
        return x > y;
    });
    std::cout << pair_min << ' ' << list_min << ' ' << reverse_min << '\n';
}

Ergebnis

3 3 7

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen