Get Random Unmarked Bit
KismetNodeHelperLibraryЧто это
Pure-функция (без exec-пинов) из библиотеки KismetNodeHelperLibrary. Выбирает случайный непомеченный (равный 0) бит в 32-битной целочисленной маске. Возвращает индекс выбранного бита или -1, если все биты помечены. Используется для случайного выбора элемента из набора, где каждый бит представляет состояние «помечен/не помечен».
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (Integer) — битовая маска, в которой ищется непомеченный бит
Выходы (данные):
- ReturnValue (Integer) — индекс случайного непомеченного бита (0–31) или -1, если все биты помечены
Когда используется
- Случайный выбор неповторяющегося элемента из фиксированного набора (например, случайный индекс в массиве, где каждый элемент может быть «использован» один раз).
- Реализация простого пула ресурсов с отметкой занятых/свободных слотов.
- Генерация случайных последовательностей без повторений в пределах 32 элементов.
Типичные проблемы
- Забытая проверка на -1 — если все биты помечены, функция вернёт -1. Использование этого значения как индекса массива или другого ресурса приведёт к крашу. Всегда проверяйте ReturnValue на -1 перед использованием.
- Неправильная инициализация маски — если маска изначально равна 0 (все биты непомечены), функция будет работать корректно, но если маска содержит случайный мусор, результат может быть неожиданным. Убедитесь, что маска явно задана (например, все биты = 1 через
Bitmaskили константу0xFFFFFFFF). - Игнорирование 32-битного ограничения — функция работает только с 32 битами. Для большего количества элементов потребуется другая логика (например, несколько масок или массив булевых значений).