Get Unmarked Bit
KismetNodeHelperLibraryЧто это
Статическая exec-функция из класса KismetNodeHelperLibrary. Ищет первый незанятый (нулевой) бит в переданном байте и возвращает его индекс (0–7). Если все биты заняты, возвращает -1. Полезна для управления пулами слотов, где каждый бит обозначает занятость.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения после завершения
Входы (данные):
- Byte (byte) — байт, в котором производится поиск первого незанятого бита
Выходы (данные):
- Return Value (integer) — индекс первого бита со значением
0(0–7), либо-1, если все биты заняты (значение1)
Когда используется
- Поиск свободного индекса в наборе из 8 элементов (например, слоты инвентаря, ID игроков).
- Управление битовыми флагами занятости в системах с небольшим количеством состояний.
Типичные проблемы
| Проблема | Описание |
|----------|----------|
| Игнорирование -1 | Использование возвращённого индекса без проверки на -1 может привести к обращению к несуществующему элементу массива или некорректной логике. |
| Несоответствие размера | Функция работает только с одним байтом (8 бит). Попытка анализировать значения больше 255 (с типом byte) автоматически обрежет данные до младших 8 бит, что может быть неочевидно. |
| Порядок битов | Индекс считается от младшего бита (LSB) к старшему. Если ожидается обратный порядок (MSB), результат будет неверным. |