6.4. 字符串函数和操作符 — PostgreSQL 7.3

支持中的版本：当前版本 (18) / 17 / 16 / 15 / 14

开发中的版本： 19 / 20devel

已结束支持的版本： 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1

历史版本。 PostgreSQL 7.3 已结束支持。请参阅当前版本手册.

6.4. 字符串函数和操作符
上一页	上一级	第 6 章函数和操作符	起始页	下一页

6.4. 字符串函数和操作符 #

本节描述用于检查和操作字符串值的函数和操作符。这里的字符串包括 CHARACTER、CHARACTER VARYING 和 TEXT 所有类型的值。除非另有说明，下面列出的所有函数都适用于这些类型，但使用 CHARACTER 类型时，应注意自动填充空格可能带来的影响。通常，这里描述的函数也能用于非字符串类型的数据，方法是先把该数据转换为字符串表示。一些函数也为位串类型提供了原生实现。

SQL定义了一些字符串函数，它们使用特殊语法，其中用某些关键字而不是逗号来分隔参数。详情见表 6.6。这些函数也使用常规的函数调用语法实现（见表 6.7）。

表 6.6. SQL字符串函数和操作符

函数	返回类型	描述	示例	结果
`string` `\|\|` `string`	`text`	字符串串接	`'Post' \|\| 'greSQL'`	`PostgreSQL`
`bit_length`(`string`)	`integer`	串中的位数	`bit_length('jose')`	`32`
`char_length`(`string`) or `character_length`(`string`)	`integer`	字符串中的字符数	`char_length('jose')`	`4`
`convert`(`string` using `conversion_name`)	`text`	使用指定的转换名更改编码。可以用`CREATE CONVERSION`定义转换，也有一些预定义的转换名。可用的转换名见表 6.8。	`convert('PostgreSQL' using iso_8859_1_to_utf_8)`	Unicode（UTF-8）编码下的`'PostgreSQL'`
`lower`(`string`)	`text`	转换字符串为小写	`lower('TOM')`	`tom`
`octet_length`(`string`)	`integer`	串中的字节数	`octet_length('jose')`	`4`
`overlay`(`string` placing `string` from `integer` [for `integer`])	`text`	插入子串	`overlay('Txxxxas' placing 'hom' from 2 for 4)`	`Thomas`
`position`(`substring` in `string`)	`integer`	指定子串的位置	`position('om' in 'Thomas')`	`3`
`substring`(`string` [from `integer`] [for `integer`])	`text`	提取子串	`substring('Thomas' from 2 for 3)`	`hom`
`substring`(`string` from `pattern`)	`text`	提取匹配 POSIX 正则表达式的子字符串	`substring('Thomas' from '...$')`	`mas`
`substring`(`string` from `pattern` for `escape`)	`text`	提取匹配 SQL 正则表达式的子串	`substring('Thomas' from '%#"o_a#"_' for '#')`	`oma`
`trim`([leading \| trailing \| both] [`characters`] from `string`)	`text`	移除`string`开始端/结束端/两端仅含`characters`（默认为空格）的最长字符串	`trim(both 'x' from 'xTomxx')`	`Tom`
`upper`(`string`)	`text`	转换字符串为大写	`upper('tom')`	`TOM`

还有一些其他的字符串处理函数可用，列于表 6.7。其中一些在内部用于实现表 6.6中列出的 SQL 标准字符串函数。

表 6.7. 其他字符串函数

函数	返回类型	描述	示例	结果
`ascii`(`text`)	integer	参数第一个字符的ASCII码。	`ascii('x')`	`120`
`btrim`(`string` `text`, `trim` `text`)	`text`	移除`string`开头和结尾处仅由`trim`中的字符组成的最长字符串	`btrim('xyxtrimyyx', 'xy')`	`trim`
`chr`(`integer`)	`text`	具有给定ASCII代码的字符	`chr(65)`	`A`
`convert`(`string` `text`, [`src_encoding` `name`,] `dest_encoding` `name`)	`text`	把字符串转换为`dest_encoding`编码。原始编码由`src_encoding`指定。如果省略`src_encoding`，则假定使用数据库编码。	`convert( 'text_in_unicode', 'UNICODE', 'LATIN1')`	ISO 8859-1 表示的`text_in_unicode`
`decode`(`string` `text`, `type` `text`)	`bytea`	解码`string`中先前用`encode()`编码的二进制数据。参数类型与`encode()`中的相同。	`decode('MTIzAAE=', 'base64')`	`123\000\001`
`encode`(`data` `bytea`, `type` `text`)	`text`	把二进制数据编码为仅含 ASCII 的表示。支持的类型有：base64、hex、escape。	`encode('123\\000\\001', 'base64')`	`MTIzAAE=`
`initcap`(`text`)	`text`	把每个单词（以空白分隔）的首字母转换为大写	`initcap('hi thomas')`	`Hi Thomas`
`length`(`string`)	`integer`	字符串的长度	`length('jose')`	`4`
`lpad`(`string` `text`, `length` `integer` [, `fill` `text`])	text	通过在前面重复字符`fill`（默认为空格）把`string`填充到长度`length`。如果`string`已经比`length`长，则将其截断（在右侧）。	`lpad('hi', 5, 'xy')`	`xyxhi`
`ltrim`(`string` `text`, `text` `text`)	`text`	移除字符串开头处仅由`trim`中的字符组成的最长字符串。	`ltrim('zzzytrim', 'xyz')`	`trim`
`pg_client_encoding`()	`name`	当前客户端编码的名称。	`pg_client_encoding()`	`SQL_ASCII`
`quote_ident`(`string` text)	`text`	返回给定字符串的适当加引号形式，使其可以在 SQL 语句字符串中用作标识符。只在必要时才加引号（即，当字符串包含非标识符字符或会被大小写折叠时）。内嵌的引号会被适当地双写。	`quote_ident('Foo')`	`"Foo"`
`quote_literal`(`string` text)	`text`	返回给定字符串的适当加引号形式，使其可以在 SQL 语句字符串中用作字面量。内嵌的引号和反斜线会被适当地双写。	`quote_literal('O\'Reilly')`	`'O''Reilly'`
`repeat`(`text`, `integer`)	`text`	将文本重复指定次数	`repeat('Pg', 4)`	`PgPgPgPg`
`replace`(`string` `text`, `from` `text`, `to` `text`)	`text`	把`string`中出现的所有子串`from`替换为`to`	`replace('abcdefabcdef', 'cd', 'XX')`	`abXXefabXXef`
`rpad`(`string` `text`, `length` `integer` [, `fill` `text`])	`text`	通过在后面重复字符 `fill`（默认为空格）把 `string` 填充到长度 `length`。如果 `string` 已经比 `length` 长，则将其截断。	`rpad('hi', 5, 'xy')`	`hixyx`
`rtrim`(`string` text, `trim` text)	`text`	移除字符串结尾处仅由`trim`中的字符组成的最长字符串。	`rtrim('trimxxxx', 'x')`	`trim`
`split_part`(`string` `text`, `delimiter` `text`, `column` `integer`)	`text`	按`delimiter`分隔`string`，返回结果所在的（从 1 开始计数的）`column`序号。	`split_part( 'abc~@~def~@~ghi', '~@~', 2)`	`def`
`strpos`(`string`, `substring`)	`int`	定位指定子串（与 `position(substring in string)` 相同，但注意参数顺序相反）	`strpos('high', 'ig')`	`2`
`substr`(`string`, `from` [, `count`])	`text`	提取指定的子串（与 `substring(string from from for count)` 相同）	`substr('alphabet', 3, 2)`	`ph`
`to_ascii`(`text` [, `encoding`])	`text`	把文本从其他编码转换为 ASCII ^[a]	`to_ascii('Karel')`	`Karel`
`to_hex`(`number` `integer` or `bigint`)	`text`	把`number`转换为等价的十六进制表示	`to_hex(9223372036854775807::bigint)`	`7fffffffffffffff`
`translate`(`string` `text`, `from` `text`, `to` `text`)	`text`	`string`中任何与`from`集合中字符匹配的字符，都会被替换成`to`集合中的相应字符。	`translate('12345', '14', 'ax')`	`a23x5`
^[a] `to_ascii` 函数只支持从 `LATIN1`、`LATIN2` 和 `WIN1250` 转换。

表 6.8. 内置转换

Conversion Name ^[a]	源编码	目标编码
`ascii_to_mic`	`SQL_ASCII`	`MULE_INTERNAL`
`ascii_to_utf_8`	`SQL_ASCII`	`UNICODE`
`big5_to_euc_tw`	`BIG5`	`EUC_TW`
`big5_to_mic`	`BIG5`	`MULE_INTERNAL`
`big5_to_utf_8`	`BIG5`	`UNICODE`
`euc_cn_to_mic`	`EUC_CN`	`MULE_INTERNAL`
`euc_cn_to_utf_8`	`EUC_CN`	`UNICODE`
`euc_jp_to_mic`	`EUC_JP`	`MULE_INTERNAL`
`euc_jp_to_sjis`	`EUC_JP`	`SJIS`
`euc_jp_to_utf_8`	`EUC_JP`	`UNICODE`
`euc_kr_to_mic`	`EUC_KR`	`MULE_INTERNAL`
`euc_kr_to_utf_8`	`EUC_KR`	`UNICODE`
`euc_tw_to_big5`	`EUC_TW`	`BIG5`
`euc_tw_to_mic`	`EUC_TW`	`MULE_INTERNAL`
`euc_tw_to_utf_8`	`EUC_TW`	`UNICODE`
`gb18030_to_utf_8`	`GB18030`	`UNICODE`
`gbk_to_utf_8`	`GBK`	`UNICODE`
`iso_8859_10_to_utf_8`	`LATIN6`	`UNICODE`
`iso_8859_13_to_utf_8`	`LATIN7`	`UNICODE`
`iso_8859_14_to_utf_8`	`LATIN8`	`UNICODE`
`iso_8859_15_to_utf_8`	`LATIN9`	`UNICODE`
`iso_8859_16_to_utf_8`	`LATIN10`	`UNICODE`
`iso_8859_1_to_mic`	`LATIN1`	`MULE_INTERNAL`
`iso_8859_1_to_utf_8`	`LATIN1`	`UNICODE`
`iso_8859_2_to_mic`	`LATIN2`	`MULE_INTERNAL`
`iso_8859_2_to_utf_8`	`LATIN2`	`UNICODE`
`iso_8859_2_to_windows_1250`	`LATIN2`	`WIN1250`
`iso_8859_3_to_mic`	`LATIN3`	`MULE_INTERNAL`
`iso_8859_3_to_utf_8`	`LATIN3`	`UNICODE`
`iso_8859_4_to_mic`	`LATIN4`	`MULE_INTERNAL`
`iso_8859_4_to_utf_8`	`LATIN4`	`UNICODE`
`iso_8859_5_to_koi8_r`	`ISO_8859_5`	`KOI8`
`iso_8859_5_to_mic`	`ISO_8859_5`	`MULE_INTERNAL`
`iso_8859_5_to_utf_8`	`ISO_8859_5`	`UNICODE`
`iso_8859_5_to_windows_1251`	`ISO_8859_5`	`WIN`
`iso_8859_5_to_windows_866`	`ISO_8859_5`	`ALT`
`iso_8859_6_to_utf_8`	`ISO_8859_6`	`UNICODE`
`iso_8859_7_to_utf_8`	`ISO_8859_7`	`UNICODE`
`iso_8859_8_to_utf_8`	`ISO_8859_8`	`UNICODE`
`iso_8859_9_to_utf_8`	`LATIN5`	`UNICODE`
`johab_to_utf_8`	`JOHAB`	`UNICODE`
`koi8_r_to_iso_8859_5`	`KOI8`	`ISO_8859_5`
`koi8_r_to_mic`	`KOI8`	`MULE_INTERNAL`
`koi8_r_to_utf_8`	`KOI8`	`UNICODE`
`koi8_r_to_windows_1251`	`KOI8`	`WIN`
`koi8_r_to_windows_866`	`KOI8`	`ALT`
`mic_to_ascii`	`MULE_INTERNAL`	`SQL_ASCII`
`mic_to_big5`	`MULE_INTERNAL`	`BIG5`
`mic_to_euc_cn`	`MULE_INTERNAL`	`EUC_CN`
`mic_to_euc_jp`	`MULE_INTERNAL`	`EUC_JP`
`mic_to_euc_kr`	`MULE_INTERNAL`	`EUC_KR`
`mic_to_euc_tw`	`MULE_INTERNAL`	`EUC_TW`
`mic_to_iso_8859_1`	`MULE_INTERNAL`	`LATIN1`
`mic_to_iso_8859_2`	`MULE_INTERNAL`	`LATIN2`
`mic_to_iso_8859_3`	`MULE_INTERNAL`	`LATIN3`
`mic_to_iso_8859_4`	`MULE_INTERNAL`	`LATIN4`
`mic_to_iso_8859_5`	`MULE_INTERNAL`	`ISO_8859_5`
`mic_to_koi8_r`	`MULE_INTERNAL`	`KOI8`
`mic_to_sjis`	`MULE_INTERNAL`	`SJIS`
`mic_to_windows_1250`	`MULE_INTERNAL`	`WIN1250`
`mic_to_windows_1251`	`MULE_INTERNAL`	`WIN`
`mic_to_windows_866`	`MULE_INTERNAL`	`ALT`
`sjis_to_euc_jp`	`SJIS`	`EUC_JP`
`sjis_to_mic`	`SJIS`	`MULE_INTERNAL`
`sjis_to_utf_8`	`SJIS`	`UNICODE`
`tcvn_to_utf_8`	`TCVN`	`UNICODE`
`uhc_to_utf_8`	`UHC`	`UNICODE`
`utf_8_to_ascii`	`UNICODE`	`SQL_ASCII`
`utf_8_to_big5`	`UNICODE`	`BIG5`
`utf_8_to_euc_cn`	`UNICODE`	`EUC_CN`
`utf_8_to_euc_jp`	`UNICODE`	`EUC_JP`
`utf_8_to_euc_kr`	`UNICODE`	`EUC_KR`
`utf_8_to_euc_tw`	`UNICODE`	`EUC_TW`
`utf_8_to_gb18030`	`UNICODE`	`GB18030`
`utf_8_to_gbk`	`UNICODE`	`GBK`
`utf_8_to_iso_8859_1`	`UNICODE`	`LATIN1`
`utf_8_to_iso_8859_10`	`UNICODE`	`LATIN6`
`utf_8_to_iso_8859_13`	`UNICODE`	`LATIN7`
`utf_8_to_iso_8859_14`	`UNICODE`	`LATIN8`
`utf_8_to_iso_8859_15`	`UNICODE`	`LATIN9`
`utf_8_to_iso_8859_16`	`UNICODE`	`LATIN10`
`utf_8_to_iso_8859_2`	`UNICODE`	`LATIN2`
`utf_8_to_iso_8859_3`	`UNICODE`	`LATIN3`
`utf_8_to_iso_8859_4`	`UNICODE`	`LATIN4`
`utf_8_to_iso_8859_5`	`UNICODE`	`ISO_8859_5`
`utf_8_to_iso_8859_6`	`UNICODE`	`ISO_8859_6`
`utf_8_to_iso_8859_7`	`UNICODE`	`ISO_8859_7`
`utf_8_to_iso_8859_8`	`UNICODE`	`ISO_8859_8`
`utf_8_to_iso_8859_9`	`UNICODE`	`LATIN5`
`utf_8_to_johab`	`UNICODE`	`JOHAB`
`utf_8_to_koi8_r`	`UNICODE`	`KOI8`
`utf_8_to_sjis`	`UNICODE`	`SJIS`
`utf_8_to_tcvn`	`UNICODE`	`TCVN`
`utf_8_to_uhc`	`UNICODE`	`UHC`
`utf_8_to_windows_1250`	`UNICODE`	`WIN1250`
`utf_8_to_windows_1251`	`UNICODE`	`WIN`
`utf_8_to_windows_1256`	`UNICODE`	`WIN1256`
`utf_8_to_windows_866`	`UNICODE`	`ALT`
`utf_8_to_windows_874`	`UNICODE`	`WIN874`
`windows_1250_to_iso_8859_2`	`WIN1250`	`LATIN2`
`windows_1250_to_mic`	`WIN1250`	`MULE_INTERNAL`
`windows_1250_to_utf_8`	`WIN1250`	`UNICODE`
`windows_1251_to_iso_8859_5`	`WIN`	`ISO_8859_5`
`windows_1251_to_koi8_r`	`WIN`	`KOI8`
`windows_1251_to_mic`	`WIN`	`MULE_INTERNAL`
`windows_1251_to_utf_8`	`WIN`	`UNICODE`
`windows_1251_to_windows_866`	`WIN`	`ALT`
`windows_1256_to_utf_8`	`WIN1256`	`UNICODE`
`windows_866_to_iso_8859_5`	`ALT`	`ISO_8859_5`
`windows_866_to_koi8_r`	`ALT`	`KOI8`
`windows_866_to_mic`	`ALT`	`MULE_INTERNAL`
`windows_866_to_utf_8`	`ALT`	`UNICODE`
`windows_866_to_windows_1251`	`ALT`	`WIN`
`windows_874_to_utf_8`	`WIN874`	`UNICODE`
^[a] 转换名称遵循标准命名规则：将源编码正式名称中的所有非字母数字字符替换为下划线，再接上 `_to_`，然后接上按相同方式处理的目标编码名称。因此，这些名称可能与惯用的编码名称不同。

上一页	上一级	下一页
6.3. 数学函数和操作符	起始页	6.5. 二进制串函数和操作符

报告文档问题

阅读上游文档. 反馈更正前请先核对当前版本手册.