Add Unique
KismetArrayLibraryЧто это
Add Unique — exec-функция из библиотеки массивов (KismetArrayLibrary). Добавляет переданный элемент в конец массива, только если такого элемента в массиве ещё нет. Если элемент уже присутствует, массив не изменяется. Возвращает индекс добавленного элемента или –1, если элемент не был добавлен.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения после завершения
Входы (данные):
- Target Array (Array) — массив, в который необходимо добавить элемент
- New Item (matching array element type) — добавляемый элемент; тип должен совпадать с типом элементов массива
Выходы (данные):
- Return Value (Integer) — индекс, по которому был добавлен элемент, или –1, если элемент уже существовал в массиве
Когда используется
- Добавление уникальных значений в коллекцию (например, список ID, ключей, уникальных объектов) без проверки наличия вручную.
- Заполнение массива из внешнего источника (события, датчики) с гарантией отсутствия дубликатов.
Типичные проблемы
- Несоответствие типа New Item типу элементов массива — если тип не совпадает, нода выдаст ошибку компиляции или не выполнится корректно.
- Игнорирование возвращаемого значения — не проверяя Return Value на –1, разработчик может не заметить, что элемент не был добавлен (уже существует), что приводит к логическим ошибкам (например, при подсчёте количества уникальных добавлений).
- Изменение массива во время итерации — вызов Add Unique внутри цикла по тому же массиву (например, For Each Loop) может привести к непредсказуемому поведению или бесконечному циклу.