CKTIS / C++
std::min — choisir la plus petite valeur
std::min, défini dans <algorithm>, sélectionne le plus petit de deux arguments ou le minimum d’une liste non vide. La surcharge à deux arguments renvoie une référence, tandis que celle prenant une liste renvoie une copie ; un comparateur facultatif définit l’ordre.
Version : 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 nécessite <algorithm>. En C++23, les surcharges sans comparateur explicite utilisent l’opérateur <, et non std::less{}. Elles ne fournissent donc pas l’ordre total strict sur les pointeurs garanti par std::less. Un comp facultatif doit définir un ordre faible strict. Deux éléments sont équivalents si aucun ne précède l’autre selon cet ordre.
std::min(a, b) renvoie const T&, qui fait référence à l’argument le plus petit, ou au premier s’ils sont équivalents. La fonction effectue exactement une comparaison. La déduction exige un T commun : std::min(1, 2.0) ne compile pas ; utilisez des types identiques ou écrivez explicitement std::min<double>(1, 2.0).
std::min({a, b, c}) renvoie par valeur une copie du premier minimum. La liste doit être non vide et T doit être constructible par copie. Pour N éléments, la fonction effectue exactement N - 1 comparaisons.
Attention à la durée de vie : const int& r = std::min(1, 2); laisse une référence pendante après la fin de l’instruction. Stocker le résultat dans un int ou un auto crée une copie sûre. Dans l’exemple, comp utilise >, donc le minimum selon l’ordre inversé est le nombre le plus grand.
Exemples
#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';
}
Résultat
3 3 7
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.