std::clamp返回闭区间[low,high]内最接近原值的数，不修改原变量；需c++17及以上、包含，三参数类型应一致以防截断，low>high时行为未定义。

std::clamp 会返回区间内最接近原值的那个数

它不修改原变量，而是返回一个新值：如果原值在 [low, high] 范围内，就返回原值；小于 low 就返回 low；大于 high 就返回 high。注意边界是闭区间，low 和 high 本身都算合法值。

必须包含 <algorithm></algorithm> 头文件，且 C++17 起才可用。低版本编译器（如 GCC 7 或 Clang 5 之前）直接用会报错：‘clamp’ is not a member of ‘std’。

基本用法和类型匹配很关键

std::clamp 是函数模板，三个参数类型要能隐式转换——通常建议全用同种类型，否则可能触发意外转换或编译失败。

• 推荐写法：int x = std::clamp(value, 0, 100);（三个都是 int）
• 危险写法：double x = std::clamp(5.5, 0, 10); —— 0 和 10 是 int，模板推导出 int 版本，导致 5.5 被截断为 5，再返回 int 结果，赋给 double 已经晚了
• 安全写法：double x = std::clamp(5.5, 0.0, 10.0); 或显式指定：std::clamp<double>(5.5, 0, 10)</double>

别拿它当“就地限制”用

std::clamp 不改变输入值，所以 std::clamp(x, 0, 100) 不会影响 x 本身。常见误用是以为它像某些语言的 inplace_clamp：

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

int x = 150;
std::clamp(x, 0, 100); // x 还是 150！
x = std::clamp(x, 0, 100); // 正确：必须显式赋值

另外，如果 low > high，行为是未定义的（不是自动交换）。实际中务必保证 low ，否则可能崩溃或返回错误结果。

替代方案：自定义宏或封装函数适合高频场景

频繁做 clamping 且希望避免类型推导陷阱时，可封装一层：

template<typename t>
constexpr T clamp_to(const T& v, const T& lo, const T& hi) {
    return (v  hi) ? hi : v;
}
</typename>

这样调用 clamp_to(x, 0, 100) 类型更稳；或者用宏（慎用，仅限简单数值场景）：#define CLAMP(v,l,h) ((v)(h)?(h):(v))。

真正容易被忽略的是：当 low 和 high 来自运行时计算（比如配置读取），要额外检查是否满足 low ，否则 <code>std::clamp 的行为不可靠。

C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！