- Categories:
BITNOT¶
Returns the bitwise negation of a numeric expression.
- Aliases:
BIT_NOT
Syntax¶
BITNOT( <expr> )
Arguments¶
expr
This expression must evaluate to a data type that can be cast to
INTEGER
.
Returns¶
Returns an integer that represents the bitwise negation of the input expression.
Usage Notes¶
If the data type of the argument is numeric but not
INTEGER
(e.g. FLOAT, DECIMAL, etc.), then the argument is cast toINTEGER
.If the data type of the argument is a string (e.g.
VARCHAR
), then the argument is cast toINTEGER
if possible. For example, the string ‘12.3’ is cast to 12. If the value cannot be cast toINTEGER
, then the value is treated as NULL.If the argument is NULL, the result is NULL.
Examples¶
This example shows how to use BITNOT
:
Create a simple table and data:
CREATE TABLE bits (ID INTEGER, bit1 INTEGER, bit2 INTEGER);INSERT INTO bits (ID, bit1, bit2) VALUES ( 11, 1, 1), -- Bits are all the same. ( 24, 2, 4), -- Bits are all different. ( 42, 4, 2), -- Bits are all different. ( 1624, 16, 24), -- Bits overlap. (65504, 0, 65504), -- Lots of bits (all but the low 6 bits) ( 0, NULL, NULL) -- No bits ;Execute the query:
SELECT bit1, bit2, BITNOT(bit1), BITNOT(bit2) FROM bits ORDER BY bit1;Output:
+------+-------+--------------+--------------+ | BIT1 | BIT2 | BITNOT(BIT1) | BITNOT(BIT2) | |------+-------+--------------+--------------| | 0 | 65504 | -1 | -65505 | | 1 | 1 | -2 | -2 | | 2 | 4 | -3 | -5 | | 4 | 2 | -5 | -3 | | 16 | 24 | -17 | -25 | | NULL | NULL | NULL | NULL | +------+-------+--------------+--------------+