Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::clamp: limitare un valore a un intervallo

std::clamp restituisce il limite inferiore, superiore o il valore stesso affinché il risultato sia nell’intervallo ordinato.

Versione: C++23

Sintassi

template<class T>
constexpr const T& clamp(const T& value, const T& low, const T& high);

template<class T, class Compare>
constexpr const T& clamp(const T& value, const T& low, const T& high, Compare comp);

std::clamp(v, lo, hi, comp) di <algorithm> prima verifica comp(v, lo) e restituisce un riferimento a lo, poi verifica comp(hi, v) e restituisce un riferimento a hi, altrimenti restituisce un riferimento a v. In C++23 l’overload senza comparatore usa std::less{}. Esegue al massimo due confronti.

La precondizione richiede che hi non preceda lo. Violare questa precondizione causa comportamento indefinito; la funzione non scambia automaticamente i limiti. Il comparatore deve dare un ordine coerente; i NaN floating-point rompono le normali ipotesi.

Il risultato è const T&. Copiarlo subito è sicuro, ma conservare il riferimento può renderlo pendente se v, lo o hi era temporaneo. Se v è equivalente a entrambi i limiti, entrambi i confronti sono falsi e il risultato si riferisce a v. La funzione non modifica gli argomenti.

Esempi

#include <algorithm>
#include <iostream>

int main() {
    const int bounded = std::clamp(12, 0, 10);
    std::cout << bounded << '\n';
}

Risultato

10

std::clamp → 10

Fonti