Get First Unmarked Bit
KismetNodeHelperLibraryЧто это
Чистая (pure) функция для работы с битовыми масками. Возвращает индекс первого нулевого (немаркированного) бита в переданном значении. Если все биты установлены (равны 1), возвращает –1. Полезна для поиска свободного слота в битовой маске, например при управлении инвентарём или состоянием объектов.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Value (Integer) — битовая маска, в которой ищется первый нулевой бит.
Выходы (данные):
- ReturnValue (Integer) — индекс первого немаркированного бита (0–31) или –1, если все биты заняты.
Когда используется
- Поиск первого свободного слота в фиксированном наборе (например, ячейки инвентаря, активные эффекты, флаги состояний).
- Оптимизация проверок: вместо цикла по всем битам — один вызов функции.
Типичные проблемы
- Забывают проверить возвращаемое значение на –1. Если все биты заняты, попытка использовать индекс –1 приведёт к выходу за границы массива или некорректной записи.
- Путают с функцией «Get First Marked Bit» (ищет первый единичный бит). Важно убедиться, что используется нужная функция для текущей задачи.
- Передают значение больше 32 бит (например, 64-битное целое). Функция работает только с 32-битной маской, старшие биты игнорируются.