Sort Trailing Events
ChaosDestructionListenerЧто это
Функция-член класса ChaosDestructionListener, предназначенная для сортировки массива trailing-событий (событий «догоняющего» разрушения) системы Chaos. Является exec-функцией (не pure) – запускается по потоку выполнения и не возвращает значения. Позволяет упорядочить события по заданному критерию (например, по силе, массе или времени) перед их обработкой в Blueprint.
Пины
Exec-входы:
- execute (exec) — запуск сортировки
Exec-выходы:
- then (exec) — продолжение выполнения после завершения сортировки
Входы (данные):
- _(точная сигнатура неизвестна – имена и типы пинов данных не указаны из-за недостаточной уверенности)_
Выходы (данные):
- нет (void) — функция не возвращает значений, сортировка применяется к переданному массиву напрямую (in‑place)
Когда используется
Типичный сценарий: после получения списка trailing-событий (например, в коллбэке On Chaos Trailing Events) необходимо отсортировать их, чтобы обработать в определённом порядке – по убыванию силы, по времени возникновения и т.п. Функция вызывается перед циклом обработки событий.
Типичные проблемы
- Забытая сортировка – без вызова этой функции события обрабатываются в исходном (неупорядоченном) порядке, что может нарушить логику расчёта урона, эффектов или разрушения.
- Неправильный критерий сортировки – если не указан или выбран неверный параметр сравнения (например, сортировка по массе вместо силы), порядок обработки не будет соответствовать замыслу разработчика.
- Мутация массива во время итерации – так как сортировка изменяет переданный массив, важно не начинать его итерацию до завершения работы функции (exec-связь
thenгарантирует это при правильном подключении).