©
本文檔使用 php中文網手册 發布
本节描述了用于检查和操作字符串数值的函数和操作符。 在这个环境中的字符串包括所有character, character varying和text类型的值。 除非另外说明,所有下面列出的函数都可以处理这些类型, 不过要小心的是,在使用character类型的时候,需要注意自动填充的潜在影响。 通常这里描述的函数也能用于非字符串类型,我们只要先把那些数据转化为字符串表现形式就可 以了。有些函数还可以处理位串类型。
SQL定义了一些字符串函数,它们有指定的语法(用特定的关键字而不是逗号来分隔参数)。 详情参阅Table 9-5,PostgreSQL也提供了这些函数的版本, 它们使用普通的函数调用语法。 (参阅Table 9-6)。
Note: 在PostgreSQL8.3之前, 这些函数将默默接受一些非字符串数据类型的值, 由于存在从这些数据类型到text的隐式强制转换,转换后的它们经常发生意外的行为,因此删除了隐式强制转换。 然而,字符串连接操作(||)仍接受非字符串输入,只要至少有一个输入一个字符串类型, 如显示在Table 9-5。对于其它情况下,如果你需要重复以前的行为, 插入一个明确的强制转换到text。
Table 9-5. SQL字符串函数和操作符
函数 | 返回类型 | 描述 | 示例 | 结果 |
---|---|---|---|---|
string|| string | text | 字符串连接 | 'Post' || 'greSQL' | PostgreSQL |
string|| non-string 或 non-string|| string | text | 一个带有非字符串输入的字符串串联 | 'Value: ' || 42 | Value: 42 |
bit_length(string) |
int | 字符串的位 | bit_length('jose') | 32 |
char_length(string) orcharacter_length(string)
|
int | 字符串中的字符个数 | char_length('jose') | 4 |
lower(string) |
text | 把字符串转化为小写 | lower('TOM') | tom |
octet_length(string) |
int | 字符串中的字节数 | octet_length('jose') | 4 |
overlay(stringplacingstringfromint[forint]) |
text | 替换子字符串 | overlay('Txxxxas' placing 'hom' from 2 for 4) | Thomas |
position(substringinstring) |
int | 指定子字符串的位置 | position('om' in 'Thomas') | 3 |
substring(string[fromint][forint]) |
text | 截取子字符串 | substring('Thomas' from 2 for 3) | hom |
substring(stringfrompattern) |
text | 截取匹配POSIX正则表达式的子字符串。参阅Section 9.7获取更多关于模式匹配的信息。 | substring('Thomas' from '...$') | mas |
substring(stringfrompatternforescape) |
text | 截取匹配SQL正则表达式的子字符串。参阅Section 9.7获取更多关于模式匹配的信息。 | 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 |
还有额外的字符串操作函数可以用,它们在Table 9-6列出。 它们有些在内部用于实现Table 9-5列出的SQL标准字符串函数。
Table 9-6. 其它字符串函数
函数 | 返回类型 | 描述 | 示例 | 结果 |
---|---|---|---|---|
ascii(string) |
int | 获取参数中第一个字符的ASCII编码值。对于UTF8返回字符的宽字节编码值。 对于其它的多字节编码,参数必须是一个ASCII字符。 | ascii('x') | 120 |
btrim(stringtext
[,characterstext]) |
text | 从string开头和结尾删除只包含characters中字符(缺省是空白)的最长字符串。 | btrim('xyxtrimyyx', 'xy') | trim |
chr(int) |
text | 给定编码的字符。对于UTF8这个参数作为宽字节代码处理。对于其它的多字节编码, 这个参数必须指定一个ASCII字符,因为text数据类型无法存储NULL数据字节,不能将NULL(0)作为字符参数。 | chr(65) | A |
convert(stringbytea,
src_encodingname,
dest_encodingname)
|
bytea | 将字符串转化为dest_encoding格式的字符串。 src_encoding表示原始的编码格式。在这种编码格式中string必须是有效的。 用CREATE CONVERSION定义转换。这也有些预定义的转换。 参阅Table 9-7显示可用的转换。 | convert('text_in_utf8', 'UTF8', 'LATIN1') | text_in_utf8represented in Latin-1 encoding (ISO 8859-1) |
convert_from(stringbytea,
src_encodingname)
|
text | 将字符串转化为数据库编码格式的,src_encoding表示原始的编码格式,这种编码格式中,string必须是有效的。 | convert_from('text_in_utf8', 'UTF8') | text_in_utf8represented in the current database encoding |
convert_to(stringtext,
dest_encodingname)
|
bytea | 将字符串转化为dest_encoding编码格式。 | convert_to('some text', 'UTF8') | some textrepresented in the UTF8 encoding |
decode(stringtext,
typetext)
|
bytea | 把前边用encode 编码的string里面的二进制数据解码。参数类型和encode 相同。
|
decode('MTIzAAE=', 'base64') | 123\000\001 |
encode(databytea,
typetext)
|
text | 把二进制数据编码为只包含ASCII形式的数据。支持的类型有base64,hex,escape。 Escape输出空字节用\000和双反斜杠. | encode(E'123\\000\\001', 'base64') | MTIzAAE= |
initcap(string) |
text | 把每个单词的第一个子母转为大写,其它的保留小写。单词是一系列字母数字组成的字符,用非字母数字分隔。 | initcap('hi THOMAS') | Hi Thomas |
length(string) |
int | string中字符数 | length('jose') | 4 |
length(stringbytea,
encodingname) |
int | 指定encoding编码格式的string的字符数。 在这个编码格式中,string必须是有效的。 | length('jose', 'UTF8') | 4 |
lpad(stringtext,
lengthint
[,filltext])
|
text | 通过填充字符fill(缺省时为空白),把string填充为length长度。 如果string已经比length长则将其尾部截断。 | lpad('hi', 5, 'xy') | xyxhi |
ltrim(stringtext
[,characterstext])
|
text | 从字符串string的开头删除只包含characters中字符(缺省为空白)的最长的字符串。 | ltrim('zzzytrim', 'xyz') | trim |
md5(string) |
text | 计算string的MD5散列,以十六进制返回结果。 | md5('abc') | 900150983cd24fb0 d6963f7d28e17f72 |
pg_client_encoding() |
name | 当前客户端编码名称 | pg_client_encoding() | SQL_ASCII |
quote_ident(stringtext) |
text | 返回适用于SQL语句的标识符形式(使用适当的引号进行界定)。只有在必要的时候才会添加引号(字符串包含非标识符字符或者会转换大小写的字符)。 里面的单引号和反斜杠会处理为双份。也可以参阅Example 39-1。 | quote_ident('Foo bar') | "Foo bar" |
quote_literal(stringtext) |
text | 返回适用于在SQL语句里当作文本使用的形式。嵌入的引号和反斜杠处理为双份。注意quote_literal 当空值输入时返回空值;如果参数可能有空值,
用这个quote_nullable 往往更合适。参阅Example 39-1。
|
quote_literal('O\'Reilly') | 'O''Reilly' |
quote_literal(valueanyelement) |
text | 将给定的值强制转换为text,加上引号作为文本。里面的单引号和反斜杠会处理为双份。 | quote_literal(42.5) | '42.5' |
quote_nullable(stringtext) |
text | 返回指定字符串适当的引用,作为一条SQL语句的字符串;或者,如果参数为空的话,返回NULL。 里面的单引号和反斜杠会处理为双份。参阅Example 39-1。 | quote_nullable(NULL) | NULL |
quote_nullable(valueanyelement) |
text | 将给定的参数值转化为text,加上引号作为文本;或者,如果参数为空的话,返回NULL。里面的单引号和反斜杠会处理为双份。 | quote_nullable(42.5) | '42.5' |
regexp_matches(stringtext,patterntext[,flagstext]) |
setof text[] | 返回string中所有匹配POSIX正则表达式的子字符串。参阅Section 9.7.3获得更多模式匹配的信息。 | regexp_matches('foobarbequebaz', '(bar)(beque)') | {bar,beque} |
regexp_replace(stringtext,patterntext,replacementtext[,flagstext]) |
text | 替换匹配POSIX正则表达式的子字符串。参阅Section 9.7.3以获取更多模式匹配的信息。 | regexp_replace('Thomas', '.[mN]a.', 'M') | ThM |
regexp_split_to_array(stringtext,patterntext[,flagstext]) |
text[] | 用POSIX正则表达式作为分隔符,分隔string。参阅Section 9.7.3以获取更多模式匹配的信息。 | regexp_split_to_array('hello world', E'\\s+') | {hello,world} |
regexp_split_to_table(stringtext,patterntext[,flagstext]) |
setof text | 用POSIX正则表达式作为分隔符,分隔string。参阅Section 9.7.3以获取更多模式匹配的信息。 | regexp_split_to_table('hello world', E'\\s+') |
hello world (2 rows) |
repeat(stringtext,numberint) |
text | 将string重复number次 | repeat('Pg', 4) | PgPgPgPg |
replace(stringtext,
fromtext,
totext) |
text | Replace all occurrences instringof substring fromwith substringto 将字符串string里出现地所有子字符串from替换成子字符串to。 | replace('abcdefabcdef', 'cd', 'XX') | abXXefabXXef |
rpad(stringtext,
lengthint
[,filltext])
|
text | 使用填充字符fill(缺省时为空白),把string填充到length长度。 如果string已经比length长则将其从尾部截断。 | rpad('hi', 5, 'xy') | hixyx |
rtrim(stringtext
[,characterstext])
|
text | 从字符串string的结尾删除只包含characters中字符(缺省是一个空白符)的最长的字符串。 | rtrim('trimxxxx', 'x') | trim |
split_part(stringtext,
delimitertext,
fieldint) |
text | 用delimiter分隔string返回给定的字段(1为基)。 | split_part('abc~@~def~@~ghi', '~@~', 2) | def |
strpos(string,substring) |
int | 指定的子字符串的位置。(同position(substringinstring),不过参数顺序相反。) | strpos('high', 'ig') | 2 |
substr(string,from[,count]) |
text | 截取子字符串。(同substring(stringfromfromforcount))) | substr('alphabet', 3, 2) | ph |
to_ascii(stringtext
[,encodingtext]) |
text | 将string从其它编码转换为ASCII(仅支持LATIN1,LATIN2,LATIN9,WIN1250编码)。 | to_ascii('Karel') | Karel |
to_hex(numberint
orbigint) |
text | 将number转换成十六进制表现形式 | to_hex(2147483647) | 7fffffff |
translate(stringtext,
fromtext,
totext)
|
text | 将string中任何匹配from字符集中的字符转化为对应的在to字符集的字符。 | translate('12345', '14', 'ax') | a23x5 |
See also the aggregate functionstring_agg
in
Section 9.18.
Table 9-7. 内置的转换
转换名 [a] | 源编码 | 目的编码 |
---|---|---|
ascii_to_mic | SQL_ASCII | MULE_INTERNAL |
ascii_to_utf8 | SQL_ASCII | UTF8 |
big5_to_euc_tw | BIG5 | EUC_TW |
big5_to_mic | BIG5 | MULE_INTERNAL |
big5_to_utf8 | BIG5 | UTF8 |
euc_cn_to_mic | EUC_CN | MULE_INTERNAL |
euc_cn_to_utf8 | EUC_CN | UTF8 |
euc_jp_to_mic | EUC_JP | MULE_INTERNAL |
euc_jp_to_sjis | EUC_JP | SJIS |
euc_jp_to_utf8 | EUC_JP | UTF8 |
euc_kr_to_mic | EUC_KR | MULE_INTERNAL |
euc_kr_to_utf8 | EUC_KR | UTF8 |
euc_tw_to_big5 | EUC_TW | BIG5 |
euc_tw_to_mic | EUC_TW | MULE_INTERNAL |
euc_tw_to_utf8 | EUC_TW | UTF8 |
gb18030_to_utf8 | GB18030 | UTF8 |
gbk_to_utf8 | GBK | UTF8 |
iso_8859_10_to_utf8 | LATIN6 | UTF8 |
iso_8859_13_to_utf8 | LATIN7 | UTF8 |
iso_8859_14_to_utf8 | LATIN8 | UTF8 |
iso_8859_15_to_utf8 | LATIN9 | UTF8 |
iso_8859_16_to_utf8 | LATIN10 | UTF8 |
iso_8859_1_to_mic | LATIN1 | MULE_INTERNAL |
iso_8859_1_to_utf8 | LATIN1 | UTF8 |
iso_8859_2_to_mic | LATIN2 | MULE_INTERNAL |
iso_8859_2_to_utf8 | LATIN2 | UTF8 |
iso_8859_2_to_windows_1250 | LATIN2 | WIN1250 |
iso_8859_3_to_mic | LATIN3 | MULE_INTERNAL |
iso_8859_3_to_utf8 | LATIN3 | UTF8 |
iso_8859_4_to_mic | LATIN4 | MULE_INTERNAL |
iso_8859_4_to_utf8 | LATIN4 | UTF8 |
iso_8859_5_to_koi8_r | ISO_8859_5 | KOI8R |
iso_8859_5_to_mic | ISO_8859_5 | MULE_INTERNAL |
iso_8859_5_to_utf8 | ISO_8859_5 | UTF8 |
iso_8859_5_to_windows_1251 | ISO_8859_5 | WIN1251 |
iso_8859_5_to_windows_866 | ISO_8859_5 | WIN866 |
iso_8859_6_to_utf8 | ISO_8859_6 | UTF8 |
iso_8859_7_to_utf8 | ISO_8859_7 | UTF8 |
iso_8859_8_to_utf8 | ISO_8859_8 | UTF8 |
iso_8859_9_to_utf8 | LATIN5 | UTF8 |
johab_to_utf8 | JOHAB | UTF8 |
koi8_r_to_iso_8859_5 | KOI8R | ISO_8859_5 |
koi8_r_to_mic | KOI8R | MULE_INTERNAL |
koi8_r_to_utf8 | KOI8R | UTF8 |
koi8_r_to_windows_1251 | KOI8R | WIN1251 |
koi8_r_to_windows_866 | KOI8R | WIN866 |
koi8_u_to_utf8 | KOI8U | UTF8 |
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 | KOI8R |
mic_to_sjis | MULE_INTERNAL | SJIS |
mic_to_windows_1250 | MULE_INTERNAL | WIN1250 |
mic_to_windows_1251 | MULE_INTERNAL | WIN1251 |
mic_to_windows_866 | MULE_INTERNAL | WIN866 |
sjis_to_euc_jp | SJIS | EUC_JP |
sjis_to_mic | SJIS | MULE_INTERNAL |
sjis_to_utf8 | SJIS | UTF8 |
tcvn_to_utf8 | WIN1258 | UTF8 |
uhc_to_utf8 | UHC | UTF8 |
utf8_to_ascii | UTF8 | SQL_ASCII |
utf8_to_big5 | UTF8 | BIG5 |
utf8_to_euc_cn | UTF8 | EUC_CN |
utf8_to_euc_jp | UTF8 | EUC_JP |
utf8_to_euc_kr | UTF8 | EUC_KR |
utf8_to_euc_tw | UTF8 | EUC_TW |
utf8_to_gb18030 | UTF8 | GB18030 |
utf8_to_gbk | UTF8 | GBK |
utf8_to_iso_8859_1 | UTF8 | LATIN1 |
utf8_to_iso_8859_10 | UTF8 | LATIN6 |
utf8_to_iso_8859_13 | UTF8 | LATIN7 |
utf8_to_iso_8859_14 | UTF8 | LATIN8 |
utf8_to_iso_8859_15 | UTF8 | LATIN9 |
utf8_to_iso_8859_16 | UTF8 | LATIN10 |
utf8_to_iso_8859_2 | UTF8 | LATIN2 |
utf8_to_iso_8859_3 | UTF8 | LATIN3 |
utf8_to_iso_8859_4 | UTF8 | LATIN4 |
utf8_to_iso_8859_5 | UTF8 | ISO_8859_5 |
utf8_to_iso_8859_6 | UTF8 | ISO_8859_6 |
utf8_to_iso_8859_7 | UTF8 | ISO_8859_7 |
utf8_to_iso_8859_8 | UTF8 | ISO_8859_8 |
utf8_to_iso_8859_9 | UTF8 | LATIN5 |
utf8_to_johab | UTF8 | JOHAB |
utf8_to_koi8_r | UTF8 | KOI8R |
utf8_to_koi8_u | UTF8 | KOI8U |
utf8_to_sjis | UTF8 | SJIS |
utf8_to_tcvn | UTF8 | WIN1258 |
utf8_to_uhc | UTF8 | UHC |
utf8_to_windows_1250 | UTF8 | WIN1250 |
utf8_to_windows_1251 | UTF8 | WIN1251 |
utf8_to_windows_1252 | UTF8 | WIN1252 |
utf8_to_windows_1253 | UTF8 | WIN1253 |
utf8_to_windows_1254 | UTF8 | WIN1254 |
utf8_to_windows_1255 | UTF8 | WIN1255 |
utf8_to_windows_1256 | UTF8 | WIN1256 |
utf8_to_windows_1257 | UTF8 | WIN1257 |
utf8_to_windows_866 | UTF8 | WIN866 |
utf8_to_windows_874 | UTF8 | WIN874 |
windows_1250_to_iso_8859_2 | WIN1250 | LATIN2 |
windows_1250_to_mic | WIN1250 | MULE_INTERNAL |
windows_1250_to_utf8 | WIN1250 | UTF8 |
windows_1251_to_iso_8859_5 | WIN1251 | ISO_8859_5 |
windows_1251_to_koi8_r | WIN1251 | KOI8R |
windows_1251_to_mic | WIN1251 | MULE_INTERNAL |
windows_1251_to_utf8 | WIN1251 | UTF8 |
windows_1251_to_windows_866 | WIN1251 | WIN866 |
windows_1252_to_utf8 | WIN1252 | UTF8 |
windows_1256_to_utf8 | WIN1256 | UTF8 |
windows_866_to_iso_8859_5 | WIN866 | ISO_8859_5 |
windows_866_to_koi8_r | WIN866 | KOI8R |
windows_866_to_mic | WIN866 | MULE_INTERNAL |
windows_866_to_utf8 | WIN866 | UTF8 |
windows_866_to_windows_1251 | WIN866 | WIN |
windows_874_to_utf8 | WIN874 | UTF8 |
euc_jis_2004_to_utf8 | EUC_JIS_2004 | UTF8 |
ut8_to_euc_jis_2004 | UTF8 | EUC_JIS_2004 |
shift_jis_2004_to_utf8 | SHIFT_JIS_2004 | UTF8 |
ut8_to_shift_jis_2004 | UTF8 | SHIFT_JIS_2004 |
euc_jis_2004_to_shift_jis_2004 | EUC_JIS_2004 | SHIFT_JIS_2004 |
shift_jis_2004_to_euc_jis_2004 | SHIFT_JIS_2004 | EUC_JIS_2004 |
Notes: a. 转换名遵循一个标准的命名模式:将源编码的正式名称中所有非字母数字字符用下划线替换,后面跟着_to_, 然后再跟着经过同样处理的目标编码的名字。因此这些名字可能和客户的编码名字不同。 |