Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori