Функция clamp

Функция clamp ограничивает значение заданным диапазоном. Она возвращает само значение, если оно находится внутри диапазона, либо нижнюю границу, если значение меньше неё, либо верхнюю границу, если значение больше неё. В первый параметр мы передаём значение, которое нужно ограничить, во второй - нижнюю границу диапазона, а в третий - верхнюю границу.

Синтаксис

clamp(value, low, high)

Функция возвращает значение типа, общего для всех трёх параметров.

Пример

Давайте ограничим число 15 диапазоном от 1 до 10. Так как 15 больше верхней границы, функция вернёт верхнюю границу:

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

int main()
{
	int res = clamp(15, 1, 10);
	cout << res << endl;
	return 0;
}

Результат выполнения кода:

10

Пример

Давайте ограничим число 5 диапазоном от 1 до 10. Так как 5 находится внутри диапазона, функция вернёт само значение:

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

int main()
{
	int res = clamp(5, 1, 10);
	cout << res << endl;
	return 0;
}

Результат выполнения кода:

5

Пример

Давайте ограничим число -3 диапазоном от 1 до 10. Так как -3 меньше нижней границы, функция вернёт нижнюю границу:

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

int main()
{
	int res = clamp(-3, 1, 10);
	cout << res << endl;
	return 0;
}

Результат выполнения кода:

1

Смотрите также

функция min,
которая возвращает минимальное значение
функция max,
которая возвращает максимальное значение
функция minmax,
которая возвращает пару из минимума и максимума
функция min_element,
которая ищет минимальный элемент в диапазоне