Is there a "canonical" name for a function combining min() and max()?

Question

I find that I frequently end up writing a function that I always call "clamp()", that is kind of a combination of min() and max(). Is there a standard, "canonical" name for this function?

It always looks something like this:

function clamp($val, $min, $max)
{
  if ($val < $min)
    return $min;
  else if ($val > $max)
    return $max;
  else
    return $val;
}

Or simply using built-in min() and max() functions:

function clamp($val, $min, $max)
{
  return max($min, min($max, $val));
}

Variations exist: You can also check for invalid input, where min > max, and either throw an exception or reverse the inputs. Or you can ignore order of the inputs and call it a median-of-three function, but that can be confusing.

Answer 1

I'd just go for a function name "rangeCheck"

Answer 2

clamp is a good name.

Let us make it the standard.

Answer 3

In the C++ STL, we have std::numerical_limits<type>, which provides both a min() and a max() function. (And some more.)

Answer 4

In some languages you have the function limit

num = limit(val, min, max)

Answer 5

clip(val, lo, hi)

Answer 6

median

Because it generalizes to more values.

Answer 7

We use pin here. Actually, we use pin for simple ranges and clamp for other stuff.