Clamp (Integer64)
KismetMathLibraryЧто это
Pure-функция (без exec-пинов) из библиотеки KismetMathLibrary. Ограничивает целочисленное значение (Integer64) заданным диапазоном [Min, Max]. Если Value меньше Min – возвращает Min, если больше Max – возвращает Max, иначе возвращает Value. Аналог математической операции clamp для 64-битных целых.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Value (Integer64) — исходное значение
- Min (Integer64) — нижняя граница диапазона
- Max (Integer64) — верхняя граница диапазона
Выходы (данные):
- ReturnValue (Integer64) — результат: Value, ограниченный диапазоном [Min, Max]
Когда используется
- Защита от выхода за допустимые пределы (индексы массивов, размеры, счётчики).
- Приведение случайного или вычисленного значения к известному диапазону без ветвлений.
- Обработка пользовательского ввода, где число не должно выходить за границы.
Типичные проблемы
- Перепутанные Min и Max – если Min > Max, функция всё равно выполнится, но результат может быть не тем, что ожидался (фактически диапазон станет [Max, Min]).
- Забытая проверка на переполнение – хотя сама функция безопасна, передача в неё результатов арифметики, которая может выйти за пределы Integer64, приведёт к некорректным данным до вызова clamp.
- Использование с нецелыми типами – функция принимает только Integer64; для Float/Double нужно выбирать соответствующие варианты Clamp (Float) / Clamp (Double).