База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::clamp: ограничаване на стойност до интервал

std::clamp връща долната граница, горната граница или самата стойност, така че резултатът да е в подредения интервал.

Версия: C++23

Синтаксис

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) от <algorithm> първо проверява comp(v, lo) и връща референция към lo, после проверява comp(hi, v) и връща референция към hi, а иначе връща референция към v. В C++23 претоварването без компаратор използва std::less{}. Изпълняват се най-много две сравнения.

Предусловието е hi да не предхожда lo. Нарушаването на това предусловие води до неопределено поведение; функцията не разменя границите автоматично. Компараторът трябва да дава последователен ред; floating-point NaN нарушава обичайните допускания.

Резултатът е const T&. Незабавно копиране е безопасно, но запазена референция може да увисне, ако v, lo или hi е временен. Ако v е еквивалентна на двете граници, и двете сравнения са лъжа и резултатът сочи v. Функцията не променя аргументите.

Примери

#include <algorithm>
#include <iostream>

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

Резултат

10

std::clamp → 10

Източници