std::clamp - cppreference.com

Si el valor de v está dentro de [lo, hi), devuelve v; de lo contrario, devuelve el límite más cercano.

1) Utiliza operator< (hasta C++20)std::less{} (desde C++20) para comparar los valores.

2) Utiliza la función de comparación comp para comparar los valores.

Si lo es mayor que hi, el comportamiento no está definido.

Parámetros

Valor de retorno

Una referencia a lo si v es menor que lo; una referencia a hi si hi es menor que v; de lo contrario, una referencia a v.

Complejidad

1) Como máximo dos comparaciones utilizando operator< (hasta C++20)std::less{} (desde C++20).

2) Como máximo dos aplicaciones de la función de comparación comp.

Posible implementación

template<class T>
constexpr const T& clamp(const T& v, const T& lo, const T& hi)
{
    return clamp(v, lo, hi, less{});
}

template<class T, class Compare>
constexpr const T& clamp(const T& v, const T& lo, const T& hi, Compare comp)
{
    return comp(v, lo) ? lo : comp(hi, v) ? hi : v;
}

Notas

Capturar el resultado de std::clamp por referencia produce una referencia pendiente si uno de los parámetros es un temporal y ese parámetro se devuelve:

int n = -1;
const int& r = std::clamp(n, 0, 255);
// r es pendiente

Si v se compara con el equivalente a cualquiera de los límites, devuelve una referencia a v, no al límite.

Ejemplo

#include <algorithm>
#include <cstdint>
#include <iomanip>
#include <iostream>

int main()
{
    std::cout << "[raw] "
                 "[" << INT8_MIN << ',' << INT8_MAX << "] "
                 "[0," << UINT8_MAX << "]\n";

    for (const int v : {-129, -128, -1, 0, 42, 127, 128, 255, 256})
        std::cout << std::setw(4) << v
                  << std::setw(11) << std::clamp(v, INT8_MIN, INT8_MAX)
                  << std::setw(8) << std::clamp(v, 0, UINT8_MAX) << '\n';
}

[raw] [-128,127] [0,255]
-129       -128       0
-128       -128       0
  -1         -1       0
   0          0       0
  42         42      42
 127        127     127
 128        127     128
 255        127     255
 256        127     255

Véase también