Skip to content

clamp ​

Clamps a number within the inclusive lower and upper bounds.

This function takes a number and two bounds, and returns the number clamped within the specified bounds. If only one bound is provided, it returns the minimum of the value and the bound.

Signature ​

typescript
function clamp(value: number, maximum: number): number;
function clamp(value: number, minimum: number, maximum: number): number;

Parameters ​

  • value (number): The number to clamp.
  • minimum (number): The minimum bound to clamp the number.
  • maximum (number): The maximum bound to clamp the number.

Returns ​

(number): The clamped number within the specified bounds.

Examples ​

typescript
import { 
clamp
} from 'js-utils-es/math';
const
result1
=
clamp
(10, 5); // result1 will be 5, as 10 is clamped to the bound 5
const
result2
=
clamp
(10, 5, 15); // result2 will be 10, as it is within the bounds 5 and 15
const
result3
=
clamp
(2, 5, 15); // result3 will be 5, as 2 is clamped to the lower bound 5
const
result4
=
clamp
(20, 5, 15); // result4 will be 15, as 20 is clamped to the upper bound 15

Source ​

Source • Docs • Test Case

Contributors ​

Changelog ​

No recent changes

Made with ❤️