【C++】标准库 std::clamp 使用方法

AnpyD

已于 2022-07-17 21:51:41 修改

阅读量1.2w

点赞数 6

文章标签： c++ 开发语言

于 2022-07-17 19:53:21 首次发布

本文链接：https://blog.csdn.net/pythonandjava/article/details/125835031

版权

本文介绍了C++17引入的std::clamp函数，用于限制值在指定范围内。std::clamp存在于algorithm头文件，返回值类型为引用，确保值在[min_value, max_value]区间。当值小于等于min_value时返回min_value引用，大于等于max_value时返回max_value引用，否则返回原值引用。" 78602376,1041776,VBA自动化：从大量Excel文件中检索数据与整合,"['VBA', 'Excel自动化', '数据处理', '批处理', '编程']

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

基本信息

所在头文件：algorithm （C++ 17及以上）
所在命名空间：std
函数原型：

// 共 2 个重载
template<class _Ty>
_NODISCARD constexpr const _Ty& clamp(const _Ty& _Val, const _Ty& _Min_val, const _Ty& _Max_val);

template <class _Ty, class _Pr>
_NODISCARD constexpr const _Ty& clamp(const _Ty& _Val, const _Ty& _Min_val, const _Ty& _Max_val, _Pr _Pred);

注：来自 MSVC 14.32.31326

解释

为了更好理解，我们对标准库的 std::clamp 整理一下，如下:

template<typename T>
constexpr const T& clamp(const T& value, const T& min_value, const T& max_value);

！！！注意：min_value 一定要小于等于 max_value

这里只展示比较常用的这个重载。

做一个不恰当的比喻：正如名字 clamp – 钳子，利用参数 min_value 和 max_value 设置了一个范围，而这个范围就好比是 ”钳嘴“，将返回值限制在这个 ”钳嘴“ 之间，范围为 [min_value, max_value]。
特别的是，返回值是一个引用，这个引用只会是 value，min_value 和 max_value 中的一个。

规则：

若 value <= min_value，返回 min_value 的引用
若 value >= max_value，返回 max_value 的引用
若 min_value < value < max_value，返回 value 的引用

示例

#include <iostream>
#include <algorithm>
using namespace std;

void foo(int a, int b, int c)
{
	// 打印传入参数
	cout << "[ "<< a << " | " << b << " | " << c <<" ]" << endl;
	// 打印输出结果
	cout << "-> " << clamp(a, b, c) << endl << endl;
}

int main()
{
	foo(1, 10, 20);
	foo(10, 10, 20);
	foo(15, 10, 20);
	foo(25, 10, 20);
}

运行结果:
result