Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::min — selecionar o valor mais pequeno

std::min, de <algorithm>, seleciona o menor de dois argumentos ou o mínimo de uma lista não vazia. A sobrecarga com dois argumentos devolve uma referência, enquanto a sobrecarga com lista devolve uma cópia; um comparador opcional define a ordenação.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <algorithm>

std::min(a, b)
std::min(a, b, comp)
std::min({a, b, c})
std::min({a, b, c}, comp)

std::min requer <algorithm>. Em C++23, as sobrecargas sem comparador explícito usam o operador <, e não std::less{}. Por isso, não oferecem a ordenação total estrita para ponteiros que std::less garante. Um comp opcional tem de definir uma ordenação fraca estrita. Dois argumentos são equivalentes quando nenhum precede o outro segundo essa ordenação.

std::min(a, b) devolve const T&, que faz referência ao argumento menor ou ao primeiro, caso sejam equivalentes. Executa exatamente uma comparação. A dedução exige um T comum: std::min(1, 2.0) não compila; use tipos compatíveis ou indique explicitamente std::min<double>(1, 2.0).

std::min({a, b, c}) devolve por valor uma cópia do primeiro mínimo. A lista tem de ser não vazia e T tem de poder ser construído por cópia. Para N elementos, executa exatamente N - 1 comparações.

Tenha atenção ao tempo de vida: const int& r = std::min(1, 2); deixa uma referência pendente quando a instrução termina. Guardar o resultado como int ou auto cria uma cópia segura. No exemplo, comp usa >, pelo que o mínimo segundo a ordenação inversa é o número maior.

Exemplos

#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';
}

Resultado

3 3 7

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes