Is Valid Timer Handle
KismetSystemLibraryЧто это
Pure-функция (не требует exec-пинов) для проверки, был ли таймер-хендл (FTimerHandle) когда-либо назначен через Set Timer by Event / Set Timer by Function. Возвращает true, если хендл валиден (активный или ожидающий таймер), и false — если хендл пустой, уже сработал (для одноразового) или был очищен.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Timer Handle (FTimerHandle) — проверяемый таймер-хендл
Выходы (данные):
- Return Value (bool) — true, если хендл валиден; false — если невалиден
Когда используется
- Перед остановкой, изменением или повторным использованием таймера, чтобы избежать ошибок в логах.
- В условных конструкциях для выбора ветки в зависимости от того, запущен ли таймер (но только для проверки факта назначения, а не активности — см. типичные проблемы).
Типичные проблемы
- Путаница с проверкой активности таймера.
IsValidTimerHandle возвращает true, если хендл был когда-либо назначен, даже если таймер уже сработал (для повторяющихся — пока не остановлен). Для проверки, работает ли таймер в данный момент, используйте Is Timer Active By Handle.
- Сравнение с nil вместо вызова функции.
FTimerHandle — структура, а не ссылка на объект. Проверка Timer Handle == nullptr в Blueprint не работает; всегда используйте Is Valid Timer Handle.
- Игнорирование невалидности после очистки.
После вызова Clear Timer Handle или срабатывания одноразового таймера хендл становится невалидным. Если не проверить его перед повторным использованием, можно получить предупреждение в логе.