Does Container Match Tag Query
BlueprintGameplayTagLibraryЧто это
Pure-функция из библиотеки BlueprintGameplayTagLibrary. Проверяет, соответствует ли контейнер тегов (GameplayTagContainer) заданному запросу тегов (GameplayTagQuery). Возвращает true, если контейнер удовлетворяет условиям запроса, иначе false. Используется для сложной фильтрации объектов по тегам (например, «имеет тег A ИЛИ (B И C, но НЕ D)»).
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- Target (GameplayTagContainer) — контейнер тегов, который проверяется
- Tag Query (GameplayTagQuery) — запрос, с которым сравнивается контейнер
Выходы (данные):
- Return Value (Boolean) — результат проверки: true, если контейнер соответствует запросу
Когда используется
- Фильтрация объектов по сложным условиям тегов (например, поиск врагов с тегом «Огонь» И «Уязвимость к холоду», но без тега «Неуязвимый»).
- Проверка, соответствует ли персонаж или предмет определённому набору теговых требований (например, для активации способности или диалога).
Типичные проблемы
- Неправильный тип запроса:
GameplayTagQuery— это не просто список тегов, а структура с логическими операторами (AND, OR, NOT). Создавать её напрямую в Blueprint сложно; обычно используютMake Gameplay Tag Queryили генерируют изGameplayTagRequirements. - Пустой контейнер или запрос: если
Targetпуст, аTag Queryтребует наличие тега — функция вернётfalse. ЕслиTag Queryпуст (не содержит условий), поведение может быть неочевидным (обычно возвращаетtrue, но лучше проверять). - Производительность при массовых проверках: функция не pure в смысле кэширования, но pure в BP — не создаёт exec-пинов. При вызове в цикле на сотнях объектов может быть нагрузка, так как каждый вызов — это C++-операция сравнения.