Lua:bAnd

From Cheat Engine
Revision as of 14:46, 3 December 2025 by Leunsel (talk | contribs) (Major overhaul of the post.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

function bAnd(int1, int2) : Integer

Performs a bitwise AND operation between two integer values. This function behaves the same as Lua's bitwise AND operator (&) in Cheat Engine. It is commonly used to check whether specific bits are set or to filter bitmask values.

Function Parameters[edit]

Parameter Type Description
int1 integer The first integer value used in the bitwise AND operation.
int2 integer The second integer value used in the bitwise AND operation.

Returns[edit]

An integer representing the result of the bitwise AND operation.

Description[edit]

The bitwise AND operation compares each bit of the two integers and sets the bit in the result to 1 only if both bits are 1. This is often used for:

  • Checking whether a specific flag is enabled
  • Filtering unwanted bits
  • Performing masked comparisons

Binary example:

1101   (13)
0101   (5)
----
0101   (5)

Usage Examples[edit]

Simple bitwise AND:

print( bAnd(13, 5) )   -- 5

Using Lua's AND operator (equivalent):

print( 13 & 5 )        -- 5

Checking if a specific flag is set:

local FLAGS = 0x0D   -- 1101
local CHECK = 0x04   -- 0100

if bAnd(FLAGS, CHECK) ~= 0 then
  print("Flag is set!")
end

Clearing bits using AND with a mask:

local value = 0x0F      -- 1111
local mask  = 0xF0      -- clears lower bits
local result = bAnd(value, mask)
print(string.format("0x%X", result))

Behavior[edit]

  • Returns an integer value.
  • Only works on numeric inputs.
  • Equivalent to Lua's native bitwise AND operator (&) in Cheat Engine.
  • Commonly used for feature flags, filtering, and masked logic.

Advanced Examples[edit]

Extracting a subset of bits (bitmask extraction):

local value = 0x3A   -- 00111010
local mask  = 0x0F   -- 00001111
local lowerNibble = bAnd(value, mask)
print(string.format("Lower nibble: %X", lowerNibble))

Checking multiple flags:

local flags = 0x37   -- 110111
local needed = 0x21  -- 100001

if bAnd(flags, needed) == needed then
  print("All required flags are set")
end

See Also[edit]

  • bOr - Bitwise OR
  • bXor - Bitwise XOR
  • bAnd - Bitwise AND
  • bShl - Bitwise Shift Left
  • bShr - Bitwise Shift Right
  • bNot - Bitwise NOT