CKTIS / C++
std::min — výběr nejmenší hodnoty
std::min z <algorithm> vybere menší ze dvou argumentů nebo minimum neprázdného seznamu. Přetížení se dvěma argumenty vrací referenci, zatímco přetížení pro seznam vrací kopii; volitelný komparátor určuje uspořádání.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <algorithm>
std::min(a, b)
std::min(a, b, comp)
std::min({a, b, c})
std::min({a, b, c}, comp)std::min vyžaduje <algorithm>. V C++23 používají přetížení bez explicitně zadaného komparátoru operátor <, nikoli std::less{}. Nezajišťují tedy striktní úplné uspořádání ukazatelů, které zaručuje std::less. Volitelný comp musí definovat striktní slabé uspořádání. Ekvivalence znamená, že žádný z argumentů není v tomto uspořádání před druhým.
std::min(a, b) vrací const T& odkazující na menší argument, případně při ekvivalenci na první. Provede přesně jedno porovnání. Odvození vyžaduje společný typ T: std::min(1, 2.0) nelze zkompilovat; použijte shodné typy nebo explicitně std::min<double>(1, 2.0).
std::min({a, b, c}) vrací hodnotou kopii prvního minima. Seznam nesmí být prázdný a T musí být kopírovatelný. Pro N prvků provede přesně N - 1 porovnání.
Dávejte pozor na dobu života: const int& r = std::min(1, 2); po skončení příkazu zanechá visící referenci. Uložením výsledku jako int nebo auto vznikne bezpečná kopie. V příkladu používá comp operátor >, takže minimum podle obráceného uspořádání je větší číslo.
Příklady
#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';
}
Výsledek
3 3 7
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.