Bitwise NOT
KismetMathLibraryЧто это
Чистая (pure) функция — выполняет побитовое отрицание (инверсию) целого числа: каждый бит входного значения заменяется на противоположный. Результат — целое число в дополнительном коде (sign‑and‑invert). Используется для битовых масок, флагов и низкоуровневых операций.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- A (Integer) — исходное целое число, все биты которого будут инвертированы
Выходы (данные):
- ReturnValue (Integer) — результат побитового NOT
Когда используется
- Сброс или установка отдельных битов в битовых масках (например, инверсия маски для удаления флагов).
- Быстрые арифметические трюки (преобразование числа в
-x-1, вычисление дополнения до единицы). - Работа с низкоуровневыми протоколами или аппаратными регистрами в Blueprint‑проектах.
Типичные проблемы
- Путаница с логическим отрицанием (
!/ NOT_Bool) —Bitwise NOTменяет все биты, а не просто инвертируетtrue/false. Для булевых значений используйтеNOT Boolean. - Забывают про знак — у знаковых целых (
int32) старший бит — знаковый, поэтому~0даёт-1, а не максимальное положительное число. Для беззнаковых масок явно приводите кbyteили используйте маски в целых без знака. - Не ожидают результата как дополнения до единицы —
~xдаёт-x-1, что может удивить при простых арифметических ожиданиях (например,~5=-6).