本节描述用于检查和操作字符串值的函数和操作符。 这里的字符串包括character、character varying和text类型的值。 除非另有说明,这些函数和操作符都声明为接受并返回text类型。 它们也可互换地接受character varying参数。 在应用函数或操作符之前,character类型的值会先转换为text,因此会去除 character 值的尾随空格。
SQL定义了一些字符串函数,它们使用关键字,而不是逗号来分隔参数。详情请见Table 9.9,PostgreSQL也提供了这些函数使用正常函数调用语法的版本(见Table 9.10)。
在 PostgreSQL 8.3 之前,由于某些非字符串数据类型到 text 的隐式强制转换,这些函数也会悄然接受那些类型的值。由于这些强制转换经常产生出人意料的行为,它们已被移除。不过,字符串串接操作符(||)仍接受非字符串输入,只要至少一个输入属于字符串类型,如Table 9.9所示。对于其他情况,如果需要重现以前的行为,可添加到 text 的显式强制转换。
Table 9.9. SQL字符串函数和操作符
|
函数/操作符 描述 示例 |
|---|
|
连接两个字符串。
|
|
将非字符串输入转换为文本,然后将两个字符串串联在一起。 (非字符串输入不能为数组类型,因为这将在
|
|
检查字符串是否处于指定的 Unicode 规范化形式中。 可选的
|
|
返回字符串中的位数(8倍于
|
|
返回字符串中的字符数。
|
|
根据数据库的语言环境规则,将字符串转换为全部小写。
|
|
将字符串转换为指定的 Unicode 规范化形式。 可选的
|
|
返回字符串的字节数。
|
|
返回字符串中的字节数。 由于此版本的函数直接接受
|
|
替换
|
|
返回
|
|
如果已指定,提取
|
|
提取匹配POSIX正则表达式的第一个子字符串; 参见 Section 9.7.3。
|
|
提取匹配 SQL 正则表达式的第一个字串;参见 Section 9.7.2。
|
|
从
|
|
这是一个非标准的
|
|
根据数据库的定位规则,将字符串转换为所有大写。
|
还有其他字符串操作函数,列在 Table 9.10 中。其中一些用于内部实现 Table 9.9 中列出的 SQL 标准字符串函数。
Table 9.10. 其他字符串函数和操作符
|
函数/操作符 描述 示例 |
|---|
|
返回参数的第一个字符的数字代码。在UTF8编码中,返回该字符的Unicode代码点。 在其他多字节编码中,该参数必须是一个ASCII字符。
|
|
从
|
|
返回给定代码的字符。在UTF8编码中该参数被视作一个Unicode代码点。 在其他多字节编码中该参数必须指定一个ASCII字符。
|
|
连接所有参数的文本表示。空参数被忽略。
|
|
用分隔符连接除第一个参数外的所有参数。第一个参数用作分隔符字符串,不应为NULL。其他NULL参数将被忽略。
|
|
根据格式字符串对参数进行格式化;参见 Section 9.4.1。 这个函数类似于C函数
|
|
将每个单词的第一个字母转换为大写,其余字母转换为小写。单词是由非字母数字字符分隔的字母数字字符序列。
|
|
以字符串返回第一个
|
|
返回字符串中的字符数。
|
|
将
|
|
从
|
|
计算参数的 MD5 hash ,结果以十六进制形式写入。
|
|
将
|
|
返回当前客户端编码名称。
|
|
返回适合引用的给定字符串,作为SQL语句字符串中的标识符。 只有在必要的情况下才添加引号(例如,如果字符串包含非标识符字符或将被大小写折叠)。 嵌入的引号被适当地加双引号。参见Example 42.1。
|
|
返回在SQL语句字符串中适当引用的给定字符串,用作字符串文字使用。 嵌入式单引号和反斜线适当的翻倍(转双引号或双斜线)。 请注意,
|
|
将给定的值转换为文本,然后将其作为字面量引用。 内嵌的单引号和反斜杠被适当地翻倍。
|
|
返回在SQL语句字符串中经过适当引用的给定字符串文字;或者,如果参数为空值,则返回
|
|
将给定值转换为文本,然后将其作为字面量引用;或者,如果参数为null,则返回
|
|
返回 POSIX 正则表达式首次匹配
|
|
返回 POSIX 正则表达式首次匹配
{bar}
{baz}
|
|
替换 POSIX 正则表达式首次匹配得到的子字符串;如果使用
|
|
使用 POSIX 正则表达式作为分隔符拆分
|
|
使用 POSIX 正则表达式作为分隔符拆分
hello world |
|
重复
|
|
将
|
|
颠倒字符串中字符的顺序。
|
|
返回字符串中的最后
|
|
扩展
|
|
从
|
|
在
|
|
返回在
|
|
提取
|
|
如果
|
|
将
|
|
将数字转换为其相应的十六进制表示形式。
|
|
将
|
concat、concat_ws和format函数是可变的,因此可以把要串接或格式化的值作为一个标记了VARIADIC关键字的数组进行传递(见Section 37.5.5)。 数组的元素被当作函数的独立普通参数一样处理。如果可变数组参数为 NULL,concat和concat_ws返回 NULL,但format把 NULL 当作一个零元素数组。
还可以参阅Section 9.21中的string_agg,以及Table 9.13中的字符串和bytea类型之间转换的功能。
format #函数format根据一个格式字符串产生格式化的输出,其形式类似于 C 函数sprintf。
format(formatstrtext[,formatarg"any"[, ...] ])
formatstr是一个格式字符串,指定结果的格式化方式。格式字符串中的文本会直接复制到结果中,但以下内容除外:格式说明符。格式说明符充当字符串中的占位符,定义如何格式化后续函数参数并将其插入结果。每个formatarg参数都按照其数据类型通常的输出规则转换为文本,然后根据格式说明符进行格式化并插入结果字符串。
格式说明符以%字符开头,格式如下:
%[position][flags][width]type
其中各组成字段为:
position(可选)一个形如的字符串,其中n$n是要打印的参数的索引。索引 1 表示紧跟在以下参数之后的第一个参数:formatstr。如果position被省略,则默认按顺序使用下一个参数。
flags(可选)用于控制格式说明符输出格式的附加选项。目前唯一支持的标志是减号(-),它使格式说明符的输出左对齐。只有同时指定了width字段时,它才有效。
width(可选)指定用于显示格式说明符输出的最小字符数。输出将被在左部或右部(取决于-标志)用空格填充以保证充满该宽度。太小的宽度设置不会导致输出被截断,但是会被简单地忽略。宽度可以使用下列形式之一指定:一个正整数;一个星号(*)表示使用下一个函数参数作为宽度;或者一个形式为*的字符串表示使用第n$n个函数参数作为宽度。
如果宽度来自一个函数参数,则在使用格式说明符对应的值参数之前,会先使用宽度参数。如果宽度参数为负数,结果会左对齐(如同指定了-标志),所占字段的长度为abs(width)。
type(必需)格式转换的类型,用于产生格式说明符的输出。支持下面的类型:
s将参数值格式化为一个简单字符串。空值会被视为空字符串。
I将参数值视作 SQL 标识符,并在必要时用双写引号包围它。如果参数为空,将会是一个错误(等效于quote_ident)。
L将参数值引用为 SQL 文字。一个空值将被显示为不带引号的字符串NULL(等效于quote_nullable)。
除了以上所述的格式说明符之外,要输出一个文字形式的%字符,可以使用特殊序列%%。
下面是一些基本格式转换的示例:
SELECT format('Hello %s', 'World');
结果:Hello World
SELECT format('Testing %s, %s, %s, %%', 'one', 'two', 'three');
结果:Testing one, two, three, %
SELECT format('INSERT INTO %I VALUES(%L)', 'Foo bar', E'O\'Reilly');
结果:INSERT INTO "Foo bar" VALUES('O''Reilly')
SELECT format('INSERT INTO %I VALUES(%L)', 'locations', 'C:\Program Files');
结果:INSERT INTO locations VALUES('C:\Program Files')
下面是使用width字段和-标志的示例:
SELECT format('|%10s|', 'foo');
结果:| foo|
SELECT format('|%-10s|', 'foo');
结果:|foo |
SELECT format('|%*s|', 10, 'foo');
结果:| foo|
SELECT format('|%*s|', -10, 'foo');
结果:|foo |
SELECT format('|%-*s|', 10, 'foo');
结果:|foo |
SELECT format('|%-*s|', -10, 'foo');
结果:|foo |
这些示例展示了如何使用position字段:
SELECT format('Testing %3$s, %2$s, %1$s', 'one', 'two', 'three');
结果:Testing three, two, one
SELECT format('|%*2$s|', 'foo', 10, 'bar');
结果:| bar|
SELECT format('|%1$*2$s|', 'foo', 10, 'bar');
结果:| foo|
不同于标准 C 函数sprintf, PostgreSQL的format函数允许在同一个格式字符串中,混合使用带有或不带有position字段的格式说明符。不带position字段的格式说明符,总是使用最后一个已使用参数之后的下一个参数。此外,format函数不要求格式字符串使用全部函数参数。例如:
SELECT format('Testing %3$s, %2$s, %s', 'one', 'two', 'three');
结果:Testing three, two, three
对于安全地构造动态 SQL 语句,%I和%L格式说明符特别有用。参见Example 42.1。