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