Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::clamp: omejitev vrednosti na interval

std::clamp vrne spodnjo mejo, zgornjo mejo ali vrednost samo, da rezultat leži v urejenem intervalu.

Različica: 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> najprej preveri comp(v, lo) in vrne referenco na lo, nato preveri comp(hi, v) in vrne referenco na hi, sicer pa vrne referenco na v. Preobremenitev brez primerjalnika v C++23 uporabi std::less{}. Izvede največ dve primerjavi.

Predpogoj je, da hi po primerjalniku ni pred lo. Kršitev tega predpogoja povzroči nedoločeno vedenje; funkcija mej ne zamenja samodejno. Primerjalnik mora dati skladen red; floating-point NaN poruši običajne predpostavke.

Rezultat je const T&. Takojšnja kopija je varna, shranjena referenca pa lahko obvisi, če je bil v, lo ali hi začasen. Če je v enakovreden obema mejama, sta obe primerjavi napačni in rezultat kaže na v. Funkcija argumentov ne spreminja.

Primeri

#include <algorithm>
#include <iostream>

int main() {
    const int bounded = std::clamp(12, 0, 10);
    std::cout << bounded << '\n';
}

Rezultat

10

std::clamp → 10

Viri