KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::clamp: waarde tot een interval beperken

std::clamp retourneert de ondergrens, bovengrens of waarde zelf zodat het resultaat in het geordende interval ligt.

Versie: 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) uit <algorithm> test eerst comp(v, lo) en retourneert een referentie naar lo, test daarna comp(hi, v) en retourneert een referentie naar hi, en retourneert anders een referentie naar v. In C++23 gebruikt de overload zonder comparator std::less{}. Er zijn hoogstens twee vergelijkingen.

Preconditie is dat hi volgens de comparator niet vóór lo ligt. Schending van deze preconditie veroorzaakt ongedefinieerd gedrag; de functie wisselt de grenzen niet automatisch. De comparator moet consistent ordenen; floating-point NaN breekt de normale aannames.

Het resultaat is const T&. Direct kopiëren is veilig, maar een bewaarde referentie kan hangen als v, lo of hi tijdelijk was. Als v equivalent is aan beide grenzen, zijn beide vergelijkingen onwaar en verwijst het resultaat naar v. Argumenten worden niet gewijzigd.

Voorbeelden

#include <algorithm>
#include <iostream>

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

Resultaat

10

std::clamp → 10

Bronnen