CKTIS / C++
std::clamp: ograničavanje vrijednosti na interval
std::clamp vraća donju granicu, gornju granicu ili samu vrijednost tako da rezultat pripada uređenom intervalu.
Verzija: C++23
Sintaksa
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) iz <algorithm> prvo ispituje comp(v, lo) i vraća referencu na lo, zatim ispituje comp(hi, v) i vraća referencu na hi, a inače vraća referencu na v. Preopterećenje bez komparatora u C++23 koristi std::less{}. Izvodi najviše dvije usporedbe.
Preduvjet je da hi prema komparatoru ne prethodi lo. Kršenje tog preduvjeta uzrokuje nedefinirano ponašanje; funkcija ne zamjenjuje granice automatski. Komparator mora dati dosljedan poredak; floating-point NaN ruši uobičajene pretpostavke.
Rezultat je const T&. Trenutno kopiranje je sigurno, ali spremljena referenca može visjeti ako je v, lo ili hi bio privremen. Ako je v ekvivalentan objema granicama, obje usporedbe su lažne i rezultat upućuje na v. Funkcija ne mijenja argumente.
Primjeri
#include <algorithm>
#include <iostream>
int main() {
const int bounded = std::clamp(12, 0, 10);
std::cout << bounded << '\n';
}
Rezultat
10
std::clamp → 10