KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::min — de kleinste waarde kiezen

std::min uit <algorithm> kiest de kleinste van twee argumenten of het minimum van een niet-lege lijst. De overload met twee argumenten retourneert een verwijzing, terwijl de lijstoverload een kopie retourneert; een optionele comparator bepaalt de ordening.

Versie: 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 vereist <algorithm>. In C++23 gebruiken de overloads zonder expliciete comparator de operator <, niet std::less{}. Ze bieden daarom niet de strikte totale ordening voor pointers die std::less garandeert. Een optionele comp moet een strikte zwakke ordening definiëren. Twee argumenten zijn equivalent als geen van beide volgens die ordening vóór het andere komt.

std::min(a, b) retourneert const T&, een verwijzing naar het kleinste argument of, bij equivalentie, naar het eerste. Het voert precies één vergelijking uit. Deductie vereist een gemeenschappelijk T: std::min(1, 2.0) compileert niet; gebruik overeenkomende typen of schrijf expliciet std::min<double>(1, 2.0).

std::min({a, b, c}) retourneert als waarde een kopie van het eerste minimum. De lijst mag niet leeg zijn en T moet kopieerbaar zijn. Bij N elementen voert de functie precies N - 1 vergelijkingen uit.

Let op de levensduur: const int& r = std::min(1, 2); laat na afloop van de instructie een bungelende verwijzing achter. Het resultaat opslaan als int of auto maakt een veilige kopie. In het voorbeeld gebruikt comp >, dus is het minimum volgens de omgekeerde ordening het grootste getal.

Voorbeelden

#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';
}

Resultaat

3 3 7

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen