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