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.