Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła