本节介绍用于检查和操作 BITSTRING 值的函数和运算符。执行按位与 (AND)、或 (OR) 和异或 (XOR) 操作时，位字符串必须长度相等。进行位移位时，字符串的原始长度会保留。
位字符串运算符
下表展示了 BIT 类型可用的数学运算符。
| 运算符 | 描述 | 示例 | 结果 |
|---|---|---|---|
& |
按位与 | '10101'::BITSTRING & '10001'::BITSTRING |
10001 |
| |
按位或 | '1011'::BITSTRING | '0001'::BITSTRING |
1011 |
xor |
按位异或 | xor('101'::BITSTRING, '001'::BITSTRING) |
100 |
~ |
按位非 | ~('101'::BITSTRING) |
010 |
<< |
按位左移 | '1001011'::BITSTRING << 3 |
1011000 |
>> |
按位右移 | '1001011'::BITSTRING >> 3 |
0001001 |
位字符串函数
下表展示了 BIT 类型可用的标量函数。
| 名称 | 描述 |
|---|---|
bit_count(bitstring) |
返回位字符串中已设置的位数。 |
bit_length(bitstring) |
返回位字符串中的位数。 |
bit_position(substring, bitstring) |
返回指定子字符串在位串中首次出现的起始索引，如果不存在则返回零。第一个（最左侧的）位索引为 1。 |
bitstring(bitstring, length) |
返回一个指定长度的位字符串。 |
get_bit(bitstring, index) |
从位字符串中提取第 n 位；第一个（最左侧的）位索引为 0。 |
length(bitstring) |
bit_length 的别名。 |
octet_length(bitstring) |
返回位字符串中的字节数。 |
set_bit(bitstring, index, new_value) |
将位字符串中的第 n 位设置为新值；第一个（最左侧的）位索引为 0。返回一个新的位字符串。 |
bit_count(bitstring)
| 描述 | 返回位字符串中已设置的位数。 |
| 示例 | bit_count('1101011'::BITSTRING) |
| 结果 | 5 |
bit_length(bitstring)
| 描述 | 返回位字符串中的位数。 |
| 示例 | bit_length('1101011'::BITSTRING) |
| 结果 | 7 |
bit_position(substring, bitstring)
| 描述 | 返回指定子字符串在位串中首次出现的起始索引，如果不存在则返回零。第一个（最左侧的）位索引为 1 |
| 示例 | bit_position('010'::BITSTRING, '1110101'::BITSTRING) |
| 结果 | 4 |
bitstring(bitstring, length)
| 描述 | 返回一个指定长度的位字符串。 |
| 示例 | bitstring('1010'::BITSTRING, 7) |
| 结果 | 0001010 |
get_bit(bitstring, index)
| 描述 | 从位字符串中提取第 n 位；第一个（最左侧的）位索引为 0。 |
| 示例 | get_bit('0110010'::BITSTRING, 2) |
| 结果 | 1 |
length(bitstring)
| 描述 | bit_length 的别名。 |
| 示例 | length('1101011'::BITSTRING) |
| 结果 | 7 |
octet_length(bitstring)
| 描述 | 返回位字符串中的字节数。 |
| 示例 | octet_length('1101011'::BITSTRING) |
| 结果 | 1 |
set_bit(bitstring, index, new_value)
| 描述 | 将位字符串中的第 n 位设置为新值；第一个（最左侧的）位索引为 0。返回一个新的位字符串。 |
| 示例 | set_bit('0110010'::BITSTRING, 2, 0) |
| 结果 | 0100010 |
位字符串聚合函数
这些聚合函数可用于 BIT 类型。
| 名称 | 描述 |
|---|---|
bit_and(arg) |
返回对给定表达式中所有位字符串执行的按位与操作的结果。 |
bit_or(arg) |
返回对给定表达式中所有位字符串执行的按位或操作的结果。 |
bit_xor(arg) |
返回对给定表达式中所有位字符串执行的按位异或操作的结果。 |
bitstring_agg(arg) |
返回一个位字符串，其中为 arg 中定义的每个不同位置设置了位。 |
bitstring_agg(arg, min, max) |
返回一个位字符串，其中为 arg 中定义的每个不同位置设置了位。所有位置必须在 [min, max] 范围内，否则将抛出超出范围错误。 |
bit_and(arg)
| 描述 | 返回对给定表达式中所有位字符串执行的按位与操作的结果。 |
| 示例 | bit_and(A) |
bit_or(arg)
| 描述 | 返回对给定表达式中所有位字符串执行的按位或操作的结果。 |
| 示例 | bit_or(A) |
bit_xor(arg)
| 描述 | 返回对给定表达式中所有位字符串执行的按位异或操作的结果。 |
| 示例 | bit_xor(A) |
bitstring_agg(arg)
| 描述 | 函数 bitstring_agg 接受任何整数类型作为输入，并返回一个位字符串，其中为每个不同值设置了位。最左侧的位代表列中的最小值，最右侧的位代表最大值。如果可能，最小值和最大值将从列统计信息中检索。否则，也可以提供最小值和最大值。 |
| 示例 | bitstring_agg(A) |
提示
bit_count和bitstring_agg的组合可以作为count(DISTINCT ...)的替代方案，在低基数和密集值的情况下可能会带来性能提升。
bitstring_agg(arg, min, max)
| 描述 | 返回一个位字符串，其中为 arg 中定义的每个不同位置设置了位。所有位置必须在 [min, max] 范围内，否则将抛出超出范围错误。 |
| 示例 | bitstring_agg(A, 1, 42) |