Resize
KismetArrayLibraryЧто это
Pure-функция? Нет. Exec-функция, которая изменяет размер переданного массива. Если новое значение Size меньше текущей длины, массив обрезается (элементы отбрасываются). Если больше — массив дополняется «пустыми» элементами (созданными конструктором по умолчанию для типа). Возвращает тот же массив по ссылке.
Пины
Exec-входы:
- execute (exec) — запуск операции.
Exec-выходы:
- then (exec) — продолжение выполнения.
Входы (данные):
- Target Array (Array — wildcard, by ref) — массив, размер которого нужно изменить.
- Size (Integer) — новый размер массива (должен быть ≥ 0).
Выходы (данные):
- Target Array (Array — wildcard) — изменённый массив (та же ссылка, что и на входе).
Когда используется
- Предварительное выделение памяти под известное количество элементов (чтобы избежать частых реаллокаций при добавлении).
- Обрезка массива до заданной длины (например, для хранения только последних N результатов).
- Заполнение массива пустыми значениями перед их последующим присваиванием.
Типичные проблемы
- Отрицательный Size — передача значения < 0 приводит к ошибке выполнения (ассерт или краш). Всегда проверяйте, что Size ≥ 0.
- Потеря данных при сокращении — при уменьшении размера элементы за пределами нового размера безвозвратно удаляются. Если данные нужны, скопируйте их заранее.
- Путаница с «Set Array» —
Resizeне заменяет всё содержимое, а только меняет длину, оставляя существующие элементы на первых позициях (если Size больше). Для полной замены используйтеSet Array ElementилиClear+Add. - Массив передаётся по ссылке — оригинальный массив изменяется «на месте». Если нужно сохранить исходную версию, перед вызовом
Resizeскопируйте массив (например, черезDuplicate Array).