9.5. 二进制串函数和操作符
本节描述那些检查和操作类型为bytea的值的函数和操作符。
SQL定义了一些使用关键字而不是逗号来分割参数的串函数。详情请见表 9-11。PostgreSQL也提供了这些函数使用常规函数调用语法的版本（参阅表 9-12）。
注意: 本页中显示的示例结果假设服务器参数bytea_output被设置为escape（传统PostgreSQL格式）。
表 9-11. 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-12列出。 其中有一些是在内部使用，用于实现表 9-11列出的 SQL 标准串函数。
表 9-12. 其他二进制串函数
| 函数 | 返回类型 | 描述 | 例子 | 结果 |
|---|---|---|---|---|
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将零字节和高位组字节转换为八进制序列（\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(E'jo\\000se'::bytea) | 5 |
md5(string)
|
text | 计算string的MD5哈希码，以十六进制形式返回结果 | md5(E'Th\\000omas'::bytea) | 8ab2d3c9689aaf18 b4958c334c82d8b1 |
set_bit(string,
offset, newvalue)
|
bytea | 设置串中的位 | set_bit(E'Th\\000omas'::bytea, 45, 0) | Th\000omAs |
set_byte(string,
offset, newvalue)
|
bytea | 设置串中的字节 | set_byte(E'Th\\000omas'::bytea, 4, 64) | Th\000o@as |
get_byte和set_byte把一个二进制串中的一个字节计数为字节 0。get_bit和set_bit在每一个字节中从右边起计数位；例如位 0 是第一个字节的最低有效位，而位 15 是第二个字节的最高有效位。
参见第 9.20 节中的聚集函数string_agg以及第 33.4 节中的大对象函数。