To Array
BlueprintSetLibraryЧто это
Функция «To Array» (Set → Array) преобразует содержимое множества (Set) в динамический массив (Array). Exec-функция (не pure) — для запуска требуется подать сигнал на вход execute.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения после завершения
Входы (данные):
- Target (Set (generic)) — исходное множество, из которого нужно получить массив
Выходы (данные):
- Out Array (Array (generic)) — результирующий массив, содержащий те же элементы, что и исходное множество
Когда используется
Когда нужно передать элементы Set в функцию, которая ожидает массив, или обработать все элементы множества стандартными узлами для массивов (For Each Loop, Get / Set Array Elem и т.п.). Также используется для сохранения Set в переменную массива (например, в структуру или для сериализации).
Типичные проблемы
- Элементы в полученном массиве располагаются в непредсказуемом порядке — Set не гарантирует порядок хранения, поэтому не следует полагаться на индексы без дополнительной сортировки.
- Функция создаёт копию данных: изменение массива не влияет на исходное множество — для обратной синхронизации нужно использовать Set-операции (Add, Remove и т.п.).
- Если множество содержит ссылочные объекты (например, Actor), массив будет содержать те же ссылки — удаление элемента из массива не разрушает объект.