Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::clamp: omezení hodnoty na interval

std::clamp vrátí dolní mez, horní mez nebo samotnou hodnotu tak, aby výsledek ležel v uspořádaném intervalu.

Verze: C++23

Syntaxe

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> nejprve otestuje comp(v, lo) a vrátí referenci na lo, poté otestuje comp(hi, v) a vrátí referenci na hi, jinak vrátí referenci na v. Přetížení bez komparátoru používá v C++23 std::less{}. Provedou se nejvýše dvě porovnání.

Předpokladem je, že hi podle komparátoru nepředchází lo. Porušení tohoto předpokladu vede k nedefinovanému chování; funkce meze automaticky nevymění. Komparátor musí tvořit konzistentní pořadí; NaN u plovoucích čísel běžné předpoklady porušuje.

Výsledek je const T&. Okamžitá kopie je bezpečná, uložená reference však může viset, byl-li v, lo či hi dočasný. Je-li v ekvivalentní oběma mezím, obě porovnání jsou nepravdivá a výsledek odkazuje na v. Funkce argumenty nemění.

Příklady

#include <algorithm>
#include <iostream>

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

Výsledek

10

std::clamp → 10

Zdroje