本节描述用于检查和操作 bytea 类型值的函数和操作符。
SQL定义了一些使用关键字而不是逗号来分隔参数的字符串函数。详情请见表 9.9。PostgreSQL也提供了这些函数使用常规函数调用语法的版本（参阅表 9.10）。
注意
本页显示的示例结果假定服务器参数 bytea_output 设为 escape（传统的 PostgreSQL 格式）。
表 9.9. SQL二进制串函数和操作符
| 函数 |
返回类型 |
描述 |
示例 |
结果 |
string || string |
bytea |
字符串串接 |
E'\\\\Post'::bytea || E'\\047gres\\000'::bytea |
\\Post'gres\000 |
octet_length(string) |
int |
二进制串中的字节数 |
octet_length(E'jo\\000se'::bytea) |
5 |
overlay(string placing string from int [for int]) |
bytea |
替换子字符串 |
overlay(E'Th\\000omas'::bytea placing E'\\002\\003'::bytea from 2 for 3) |
T\\002\\003mas |
position(substring in string) |
int |
指定子字符串的位置 |
position(E'\\000om'::bytea in E'Th\\000omas'::bytea) |
3 |
substring(string [from int] [for int]) |
bytea |
提取子字符串 |
substring(E'Th\\000omas'::bytea from 2 for 3) |
h\000o |
trim([both] bytes from string) |
bytea |
从 string 的开头和结尾移除仅由 bytes 中字节组成的最长字符串 |
trim(E'\\000'::bytea from E'\\000Tom\\000'::bytea) |
Tom |
还有一些二进制串处理函数可以使用，在表 9.10列出。 其中有一些是在内部使用，用于实现表 9.9列出的 SQL 标准串函数。
表 9.10. 其他二进制串函数
| 函数 |
返回类型 |
描述 |
示例 |
结果 |
btrim(string bytea, bytes bytea) |
bytea |
从 string 的开头和结尾移除仅由 bytes 中字节组成的最长字符串 |
btrim(E'\\000trim\\000'::bytea, E'\\000'::bytea) |
trim |
decode(string text, format text) |
bytea |
从 string 中的文本表示解码二进制数据。format 的选项与 encode 相同。 |
decode(E'123\\000456', 'escape') |
123\000456 |
encode(data bytea, format text) |
text |
将二进制数据编码为文本表示。支持的格式为：base64、hex、escape。escape 将零字节和最高位为 1 的字节转换为八进制序列（\nnn），并将反斜杠双写。 |
encode(E'123\\000456'::bytea, 'escape') |
123\000456 |
get_bit(string, offset) |
int |
从字符串中提取位 |
get_bit(E'Th\\000omas'::bytea, 45) |
1 |
get_byte(string, offset) |
int |
从字符串中提取字节 |
get_byte(E'Th\\000omas'::bytea, 4) |
109 |
length(string) |
int |
二进制串的长度 |
length('jo\000se'::bytea) |
5 |
md5(string) |
text |
计算 string 的 MD5 hash，并以十六进制返回结果 |
md5('Th\000omas'::bytea) |
8ab2d3c9689aaf18 b4958c334c82d8b1 |
set_bit(string, offset, newvalue) |
bytea |
设置字符串中的位 |
set_bit('Th\000omas'::bytea, 45, 0) |
Th\000omAs |
set_byte(string, offset, newvalue) |
bytea |
设置字符串中的字节 |
set_byte('Th\000omas'::bytea, 4, 64) |
Th\000o@as |
函数get_byte和set_byte把二进制串中的第一个字节编号为字节 0。 函数get_bit和set_bit在每一个字节中从右边起计数位； 例如位 0 是第一个字节的最低有效位，而位 15 是第二个字节的最高有效位。