Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::clamp: obmedzenie hodnoty na interval

std::clamp vráti dolnú hranicu, hornú hranicu alebo samotnú hodnotu tak, aby výsledok ležal v usporiadanom intervale.

Verzia: C++23

Syntax

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) z <algorithm> najprv otestuje comp(v, lo) a vráti referenciu na lo, potom otestuje comp(hi, v) a vráti referenciu na hi, inak vráti referenciu na v. Preťaženie bez komparátora používa v C++23 std::less{}. Vykonajú sa najviac dve porovnania.

Predpokladom je, že hi podľa komparátora nepredchádza lo. Porušenie tohto predpokladu vedie k nedefinovanému správaniu; funkcia hranice automaticky nevymení. Komparátor musí tvoriť konzistentné poradie; NaN pri plávajúcich číslach bežné predpoklady porušuje.

Výsledok je const T&. Okamžitá kópia je bezpečná, uložená referencia však môže visieť, ak bol v, lo či hi dočasný. Ak je v ekvivalentné obom hraniciam, obe porovnania sú nepravdivé a výsledok odkazuje na v. Funkcia argumenty nemení.

Príklady

#include <algorithm>
#include <iostream>

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

Výsledok

10

std::clamp → 10

Zdroje