Name: bitNot

Type: operator

Syntax: bitNot <number>

Summary:

Performs a "bitwise not" <operation> on the <binary> representation of a

number as an unsigned, 32-bit integer

Introduced: 1.0

OS: mac, windows, linux, ios, android

Platforms: desktop, server, mobile

Example:

bitNot 1 -- evaluates to 4294967294

Example:

bitNot 14 -- in binary: bitNot 0000000000001110; evaluates to 1111111111110001; converted to 4294967281

Parameters:

number:

A number, or an expression that evaluates to a number, between zero and

4,294,967,295 (2^32 - 1).

Description:

Use the <bitNot> <operator> to operate directly on the <bit|bits> of a

number.

To perform the <bitNot> <operation>, LiveCode first converts the

<operand> to its <binary> equivalent, a string of ones and zeroes. 1 is

equivalent to true, and 0 is equivalent to false.

For each bit of the <number>, LiveCode performs a <not> <operation>. A

<bit> is 0 if the corresponding <bit> of the <number> is 1, and 1 if the

corresponding <bit> of the <number> is 0.

Finally, the binary number thus created is converted back to decimal.

References: baseConvert (function), operation (glossary),

operator (glossary), bit (glossary), binary (glossary),

operand (glossary), bitAnd (operator), not (operator), bitOr (operator),

bitXor (operator)

Tags: math