Add
BlueprintMapLibraryЧто это
Exec-функция, добавляет в карту новую пару «ключ — значение». Если ключ уже существует, операция перезаписывает значение (при стандартном поведении; в отличие от «Add Unique», которая запрещает дубликаты). Тип ключа и значения задаётся при создании переменной-карты.
Пины
Exec-входы:
- execute (exec) — запуск добавления.
Exec-выходы:
- then (exec) — продолжение выполнения после вставки.
Входы (данные):
- Target (Map) — карта, в которую добавляется элемент. Обычно подключается через ссылку на переменную-карту (сама карта передаётся, не копия).
- Key (тип ключа карты) — ключ для нового элемента.
- Value (тип значения карты) — значение, привязанное к этому ключу.
Выходы (данные):
Нет (void) — функция не возвращает никаких данных.
Когда используется
- Для пополнения карты новыми данными или обновления существующих записей.
- При сборке конфигураций, таблиц соответствий, кэшей игровых объектов, когда ключ однозначно определяет элемент (например, ID → актёр, имя → статистика).
Типичные проблемы
- Случайное перезаписывание существующего ключа — если надо предотвратить замену, используйте «Add Unique» или проверяйте наличие ключа через «Contains» перед вызовом.
- Использование ссылочного типа как ключа — объекты (Actor, Class) можно использовать как ключи, но сравнение происходит по ссылке, а не по содержимому. Два разных объекта с одинаковыми внутренними данными будут считаться разными ключами.
- Передача карты по значению вместо ссылки — в Blueprint карты являются ссылочными типами, но если нода «Add» подключена не к той переменной (через «get» копию), изменения могут не сохраниться. Всегда используйте «Set» или прямую передачу карты через Target-пин.