Nearly Equal (Float)
KismetMathLibraryЧто это
Pure-функция (не требует exec), сравнивает два числа с плавающей точкой на «почти равенство» в пределах заданного допуска. Возвращает true, если разница между A и B меньше или равна ErrorTolerance, иначе false. Позволяет избежать проблем с накоплением погрешности при сравнении float во временных или физических вычислениях.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- A (float) — первое число для сравнения
- B (float) — второе число для сравнения
- ErrorTolerance (float) — максимальная допустимая разница; если
|A - B| <= ErrorTolerance, результат true
Выходы (данные):
- ReturnValue (bool) — true если числа почти равны, false в противном случае
Когда используется
- Проверка условий вроде «физическая величина достигла целевого значения» без жёсткого
==, который может не сработать из-за float-погрешности. - Сравнение результатов математических операций (например, после Lerp, интерполяции, тригонометрии) с эталонными значениями.
- Безопасная проверка близости углов, расстояний, скоростей в игровой логике.
Типичные проблемы
- Слишком малый ErrorTolerance — если допуск меньше накопленной погрешности, сравнение никогда не будет истинным (функция ведёт себя как
==). Рекомендуется 0.001–0.01 для большинства игровых сценариев. - Перепутанные A и B — функция симметрична, но путаница ухудшает читаемость графа. Привыкайте ставить «ожидаемое значение» в A, «текущее» в B.
- Игнорирование знака ошибки — функция использует модуль разности, поэтому отрицательная разница не имеет значения. Если критичен порядок (например, «A должно быть строго меньше B»), используйте обычное сравнение, а не эту функцию.