Find
BlueprintMapLibraryЧто это
Функция Find из библиотеки BlueprintMapLibrary. Это exec-функция, которая ищет значение по ключу в переданной карте (Map). Если ключ найден, возвращает true и соответствующее значение; если нет — возвращает false, а выходное значение остаётся дефолтным (DefaultValue). Полезна для безопасного чтения из Map без риска краша при отсутствии ключа.
Пины
Exec-входы:
- execute (exec) — запуск поиска
Exec-выходы:
- then (exec) — продолжение выполнения после завершения поиска
Входы (данные):
- Target Map (Map) — карта, в которой производится поиск
- Key (тип ключа карты) — ключ, значение которого нужно найти
- Default Value (тип значения карты) — значение, возвращаемое, если ключ не найден
Выходы (данные):
- Out Value (тип значения карты) — найденное значение (или Default Value, если ключ отсутствует)
- Return Value (Boolean) —
true, если ключ найден в карте;false— если нет
Когда используется
- Проверка наличия элемента в ассоциативном массиве (например, ID персонажа → его класс, имя тега → ссылка на объект).
- Безопасное чтение из Map, когда ключ может отсутствовать — вместо прямого доступа (который в BP не скомпилируется без проверки).
- Реализация кэша или таблицы соответствий, где нужно различать «ключ есть, но значение null» и «ключа нет».
Типичные проблемы
- Забытый Default Value: если не задать значение по умолчанию, при отсутствии ключа выходной пин получит дефолт типа (например, 0 для int, None для Object), что может привести к неожиданному поведению.
- Путаница с ключом и значением: в Map-функциях важно не перепутать тип ключа (слева) и тип значения (справа) — ошибка компиляции не возникнет, но результат будет некорректным.
- Игнорирование Return Value: если не проверять булевый выход, код будет использовать Out Value, даже когда ключа нет — это может привести к логическим ошибкам (например, спавн объекта по дефолтному классу вместо отсутствия спавна).