Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::clamp : borner une valeur dans un intervalle

std::clamp renvoie la borne basse, la borne haute ou la valeur afin que le résultat appartienne à l’intervalle ordonné.

Version : 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) de <algorithm> teste d’abord comp(v, lo) et renvoie une référence vers lo, puis teste comp(hi, v) et renvoie une référence vers hi, sinon elle renvoie une référence vers v. En C++23, la surcharge sans comparateur utilise std::less{}. Au plus deux comparaisons sont effectuées.

La précondition exige que hi ne précède pas lo. Violer cette précondition entraîne un comportement indéfini ; la fonction n’échange pas automatiquement les bornes. Le comparateur doit former un ordre cohérent ; les NaN flottants brisent les hypothèses habituelles.

Le résultat est un const T&. Le copier immédiatement est sûr, mais conserver la référence peut la rendre pendante si v, lo ou hi était temporaire. Si v est équivalente aux deux bornes, les deux comparaisons sont fausses et le résultat désigne v. La fonction ne modifie aucun argument.

Exemples

#include <algorithm>
#include <iostream>

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

Résultat

10

std::clamp → 10

Sources