11.1.5 位值字面量
Bit-value literals are written using b'
or val
'0b
notation. val
val
is a binary value written using zeros and ones. Lettercase of any leading b
does not matter. A leading 0b
is case-sensitive and cannot be written as 0B
.
Legal bit-value literals:
b'01'
B'01'
0b01
Illegal bit-value literals:
b'2' (2 is not a binary digit)
0B01 (0B must be written as 0b)
By default, a bit-value literal is a binary string:
mysql> SELECT b'1000001', CHARSET(b'1000001');
+------------+---------------------+
| b'1000001' | CHARSET(b'1000001') |
+------------+---------------------+
| A | binary |
+------------+---------------------+
mysql> SELECT 0b1100001, CHARSET(0b1100001);
+-----------+--------------------+
| 0b1100001 | CHARSET(0b1100001) |
+-----------+--------------------+
| a | binary |
+-----------+--------------------+
A bit-value literal may have an optional character set introducer and COLLATE
clause, to designate it as a string that uses a particular character set and collation:
[_charset_name] b'val' [COLLATE collation_name]
Examples:
SELECT _latin1 b'1000001';
SELECT _utf8mb4 0b1000001 COLLATE utf8mb4_danish_ci;
The examples use b'
notation, but val
'0b
notation permits introducers as well. For information about introducers, see Section 12.3.8, “Character Set Introducers”.val
In numeric contexts, MySQL treats a bit literal like an integer. To ensure numeric treatment of a bit literal, use it in numeric context. Ways to do this include adding 0 or using CAST(... AS UNSIGNED)
. For example, a bit literal assigned to a user-defined variable is a binary string by default. To assign the value as a number, use it in numeric context:
mysql> SET @v1 = b'1100001';
mysql> SET @v2 = b'1100001'+0;
mysql> SET @v3 = CAST(b'1100001' AS UNSIGNED);
mysql> SELECT @v1, @v2, @v3;
+------+------+------+
| @v1 | @v2 | @v3 |
+------+------+------+
| a | 97 | 97 |
+------+------+------+
An empty bit value (b''
) evaluates to a zero-length binary string. Converted to a number, it produces 0:
mysql> SELECT CHARSET(b''), LENGTH(b'');
+--------------+-------------+
| CHARSET(b'') | LENGTH(b'') |
+--------------+-------------+
| binary | 0 |
+--------------+-------------+
mysql> SELECT b''+0;
+-------+
| b''+0 |
+-------+
| 0 |
+-------+
Bit-value notation is convenient for specifying values to be assigned to BIT
columns:
mysql> CREATE TABLE t (b BIT(8));
mysql> INSERT INTO t SET b = b'11111111';
mysql> INSERT INTO t SET b = b'1010';
mysql> INSERT INTO t SET b = b'0101';
Bit values in result sets are returned as binary values, which may not display well. To convert a bit value to printable form, use it in numeric context or use a conversion function such as BIN()
or HEX()
. High-order 0 digits are not displayed in the converted value.
mysql> SELECT b+0, BIN(b), OCT(b), HEX(b) FROM t;
+------+----------+--------+--------+
| b+0 | BIN(b) | OCT(b) | HEX(b) |
+------+----------+--------+--------+
| 255 | 11111111 | 377 | FF |
| 10 | 1010 | 12 | A |
| 5 | 101 | 5 | 5 |
+------+----------+--------+--------+
For bit literals, bit operations are considered numeric context, but bit operations permit numeric or binary string arguments in MySQL 8.4 and higher. To explicitly specify binary string context for bit literals, use a _binary
introducer for at least one of the arguments:
mysql> SET @v1 = b'000010101' | b'000101010';
mysql> SET @v2 = _binary b'000010101' | _binary b'000101010';
mysql> SELECT HEX(@v1), HEX(@v2);
+----------+----------+
| HEX(@v1) | HEX(@v2) |
+----------+----------+
| 3F | 003F |
+----------+----------+
The displayed result appears similar for both bit operations, but the result without _binary
is a BIGINT
value, whereas the result with _binary
is a binary string. Due to the difference in result types, the displayed values differ: High-order 0 digits are not displayed for the numeric result.