Band

From Pico-8 Wiki
Jump to navigation Jump to search
Superseded / Deprecated
The feature described in this article has been superseded by a newer feature. This feature still works in PICO-8, but the new feature should be used instead. See the article's "Superseded by..." section for specific details.
band( first, second )
Calculates the bitwise-and of two numbers.
first
The first number.

second
The second number.

return-value
The bitwise-and of first and second.

Superseded by & operator

The & operator added in 0.2.0 performs the same function as band() and is now the recommended way to do bitwise and, as it uses fewer tokens, costs fewer cycles at runtime, and runs on the real host CPU much more efficiently. Simply replace band(a,b) with a&b.

Examples

--     0x7 = 0111 binary
-- and 0xd = 1101 binary
-- -------
--     0x5 = 0101 binary
print(band(0x7, 0xd))  -- 5

print(0x7 & 0xd)       -- preferred method

See also