CKTIS / C++
std::min — wybór najmniejszej wartości
std::min z nagłówka <algorithm> wybiera mniejszy z dwóch argumentów albo minimum niepustej listy. Wariant dwuargumentowy zwraca referencję, a wariant listowy — kopię; opcjonalny komparator określa porządek.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <algorithm>
std::min(a, b)
std::min(a, b, comp)
std::min({a, b, c})
std::min({a, b, c}, comp)std::min wymaga nagłówka <algorithm>. W C++23 warianty bez jawnie podanego komparatora używają operatora <, a nie std::less{}. Nie zapewniają więc ścisłego porządku całkowitego dla wskaźników gwarantowanego przez std::less. Opcjonalny comp musi definiować ścisły słaby porządek. Równoważność oznacza, że żaden argument nie poprzedza drugiego według tego porządku.
std::min(a, b) zwraca const T& do mniejszego argumentu, a przy równoważności — do pierwszego. Wykonuje dokładnie jedno porównanie. Dedukcja wymaga wspólnego T: std::min(1, 2.0) nie kompiluje się; użyj zgodnych typów lub jawnego std::min<double>(1, 2.0).
std::min({a, b, c}) zwraca przez wartość kopię pierwszego minimum. Lista musi być niepusta, a T musi być kopiowalny. Dla N elementów wykonuje dokładnie N - 1 porównań.
Uważaj na czas życia: const int& r = std::min(1, 2); pozostawia wiszącą referencję po zakończeniu instrukcji. Zapisanie wyniku jako int lub auto tworzy bezpieczną kopię. W przykładzie comp używa >, więc minimum według odwróconego porządku to większa liczba.
Przykłady
#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';
}
Wynik
3 3 7
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.