CKTIS / C++
std::clamp: limitar un valor a un intervalo
std::clamp devuelve el límite inferior, el superior o el propio valor para que el resultado pertenezca al intervalo ordenado.
Versión: C++23
Sintaxis
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), de <algorithm>, primero prueba comp(v, lo) y devuelve referencia a lo, después prueba comp(hi, v) y devuelve referencia a hi, y en otro caso devuelve referencia a v. En C++23, la sobrecarga sin comparador usa std::less{}. Realiza como máximo dos comparaciones.
La precondición exige que hi no preceda a lo. Incumplir esta precondición provoca comportamiento indefinido; la función no intercambia automáticamente los límites. El comparador debe dar un orden coherente; los NaN flotantes rompen las suposiciones habituales.
El resultado es const T&. Copiarlo de inmediato es seguro, pero guardar la referencia puede dejarla colgante si v, lo o hi era temporal. Si v es equivalente a ambos límites, las dos comparaciones son falsas y el resultado referencia v. La función no modifica argumentos.
Ejemplos
#include <algorithm>
#include <iostream>
int main() {
const int bounded = std::clamp(12, 0, 10);
std::cout << bounded << '\n';
}
Resultado
10
std::clamp → 10