文档首页/ 云数据库 GaussDB/ 开发指南（集中式_V2.0-2.x）/ SQL参考/ 函数和操作符/ 字符处理函数和操作符

更新时间：2024-12-19 GMT+08:00

字符处理函数和操作符

GaussDB提供的字符处理函数和操作符主要用于字符串与字符串、字符串与非字符串之间的连接，以及字符串的模式匹配操作。注意：字符串处理函数除了length相关函数，其他函数和操作符不支持大于1GB clob作为参数。

bit_length(string)

描述：字符串的位数。

返回值类型：int

示例：

     
          openGauss=# SELECT bit_length('world');
 bit_length
------------
         40
(1 row)

btrim(string text [, characters text])
描述：从string开头和结尾删除只包含characters中字符（缺省是空白）的最长字符串。

返回值类型：text

示例：
1 2 3 4 5

openGauss=# SELECT btrim('sring' , 'ing'); btrim ------- sr (1 row)

char_length(string)或character_length(string)

描述：字符串中的字符个数。

返回值类型：int

示例：

     
          openGauss=# SELECT char_length('hello');
 char_length
-------------
           5
(1 row)

instr(text,text,int,int)

描述：instr(string1,string2,int1,int2)返回在string1中从int1位置开始匹配到第int2次string2的位置，第一个int表示开始匹配起始位置，第二个int表示匹配的次数。

返回值类型：int

示例：

     
          openGauss=# SELECT instr( 'abcdabcdabcd', 'bcd', 2, 2 );
 instr
-------
     6
(1 row)

lengthb(text/bpchar)

描述：获取指定字符串的字节数。

返回值类型：int

示例：

     
          openGauss=# SELECT lengthb('hello');
 lengthb
---------
       5
(1 row)

left(str text, n int)
描述：返回字符串的前n个字符。当n是负数时，返回除最后|n|个字符以外的所有字符。

返回值类型：text

示例：
1 2 3 4 5

openGauss=# SELECT left('abcde', 2); left ------ ab (1 row)

length(string bytea, encoding name )

描述：指定encoding编码格式的string的字符数。在这个编码格式中，string必须是有效的。

返回值类型：int

示例：

     
          openGauss=# SELECT length('jose', 'UTF8');
 length
--------
      4
(1 row)

如果是查询bytea类型的长度，指定utf8编码时，最大长度只能为536870888。

lpad(string text, length int [, fill text])
描述：通过填充字符fill（缺省时为空白），把string填充为length长度。如果string已经比length长则将其尾部截断。

返回值类型：text

示例：
1 2 3 4 5

openGauss=# SELECT lpad('hi', 5, 'xyza'); lpad ------- xyzhi (1 row)

notlike(x bytea name text, y bytea text)

描述：比较x和y是否不一致。

返回值类型：Boolean

示例：

     
          openGauss=# SELECT notlike(1,2);
    notlike
--------------
            t
(1 row)
openGauss=# SELECT notlike(1,1);
    notlike
--------------
            f
(1 row)

octet_length(string)

描述：字符串中的字节数。

返回值类型：int

示例：

     
          openGauss=# SELECT octet_length('jose');
 octet_length
--------------
            4
(1 row)

overlay(string placing string FROM int [for int])

描述：替换子字符串。FROM int表示从第一个string的第几个字符开始替换，for int表示替换第一个string的字符数目。

返回值类型：text

示例：

     
          openGauss=# SELECT overlay('hello' placing 'world' from 2 for 3 );
 overlay 
---------
 hworldo
(1 row)

position(substring in string)

描述：指定子字符串的位置。字符串区分大小写。

返回值类型：int，字符串不存在时返回0。

示例：

     
          openGauss=# SELECT position('ing' in 'string');
 position
----------
        4
(1 row)

pg_client_encoding()

描述：当前客户端编码名称。

返回值类型：name

示例：

     
          openGauss=# SELECT pg_client_encoding();
 pg_client_encoding
--------------------
 UTF8
(1 row)

quote_ident(string text)

描述：返回适用于SQL语句的标识符形式（使用适当的引号进行界定）。只有在必要的时候才会添加引号（字符串包含非标识符字符或者会转换大小写的字符）。返回值中嵌入的引号都写了两次。

返回值类型：text

示例：

     
          openGauss=# SELECT quote_ident('hello world');
 quote_ident
--------------
 "hello world"
(1 row)

quote_literal(string text)

描述：返回适用于在SQL语句里当作文本使用的形式（使用适当的引号进行界定）。

返回值类型：text

示例：

     
          openGauss=# SELECT quote_literal('hello');
 quote_literal 
---------------
 'hello'
(1 row)

如果出现如下写法，text文本将进行转义。

     
          openGauss=# SELECT quote_literal(E'O\'hello');
 quote_literal
---------------
 'O''hello'
(1 row)

如果出现如下写法，反斜杠会写入两次。

     
          openGauss=# SELECT quote_literal('O\hello');
 quote_literal 
---------------
 E'O\\hello'
(1 row)

如果参数为NULL，返回空。如果参数可能为null，通常使用函数quote_nullable更适用。

     
          openGauss=# SELECT quote_literal(NULL);
 quote_literal 
---------------

(1 row)

quote_literal(value anyelement)

描述：将给定的值强制转换为text，加上引号作为文本。

返回值类型：text

示例：

     
          openGauss=# SELECT quote_literal(42.5);
 quote_literal 
---------------
 '42.5'
(1 row)

如果出现如下写法，定值将进行转义。

     
          openGauss=# SELECT quote_literal(E'O\'42.5');
 quote_literal
---------------
 '0''42.5'
(1 row)

如果出现如下写法，反斜杠会写入两次。

     
          openGauss=# SELECT quote_literal('O\42.5');
 quote_literal 
---------------
 E'O\\42.5'
(1 row)

quote_nullable(string text)

描述：返回适用于在SQL语句里当作字符串使用的形式（使用适当的引号进行界定）。

返回值类型：text

示例：

     
          openGauss=# SELECT quote_nullable('hello');
 quote_nullable 
----------------
 'hello'
(1 row)

如果出现如下写法，text文本将进行转义。

     
          openGauss=# SELECT quote_nullable(E'O\'hello');
 quote_nullable
----------------
 'O''hello'
(1 row)

如果出现如下写法，反斜杠会写入两次。

     
          openGauss=# SELECT quote_nullable('O\hello');
 quote_nullable
----------------
 E'O\\hello'
(1 row)

如果参数为NULL，返回NULL。

     
          openGauss=# SELECT quote_nullable(NULL);
 quote_nullable
----------------
 NULL
(1 row)

quote_nullable(value anyelement)

描述：将给定的参数值转换为text，加上引号作为文本。

返回值类型：text

示例：

     
          openGauss=# SELECT quote_nullable(42.5);
 quote_nullable
----------------
 '42.5'
(1 row)

如果出现如下写法，定值将进行转义。

     
          openGauss=# SELECT quote_nullable(E'O\'42.5');
 quote_nullable 
----------------
 'O''42.5'
(1 row)

如果出现如下写法，反斜杠会写入两次。

     
          openGauss=# SELECT quote_nullable('O\42.5');
 quote_nullable
----------------
 E'O\\42.5'
(1 row)

如果参数为NULL，返回NULL。

     
          openGauss=# SELECT quote_nullable(NULL);
 quote_nullable
----------------
 NULL
(1 row)

substring_inner(string [from int] [for int])

描述：截取子字符串，from int表示从第几个字符开始截取，for int表示截取几个字节。

返回值类型：text

示例：

     
          openGauss=# SELECT substring_inner('adcde', 2,3);
 substring_inner
-----------------
 dcd
(1 row)

substring(string [from int] [for int])

描述：截取子字符串，from int表示从第几个字符开始截取，for int表示截取几个字节。

返回值类型：text

示例：

     
          openGauss=# SELECT substring('Thomas' from 2 for 3);
 substring
-----------
 hom
(1 row)

rawcat(raw,raw)

描述：字符串拼接函数。

返回值类型：raw

示例：

     
          openGauss=# SELECT rawcat('ab','cd');
 rawcat
--------
 ABCD
(1 row)

regexp_count(string text, pattern text [, position int [, flags text]])
描述：获取满足匹配的子串个数。

参数说明：
- string：用于匹配的源字符串。
- pattern：用于匹配的正则表达式模式串。
- position：表示从源字符串的第几个字符开始匹配，为可选参数，默认值为1。
- flags：可选参数，包含零个或多个改变函数匹配行为的单字母标记。flags 支持的选项值及含义描述请参见《实验室特性说明》中“C Function > 接口介绍 > 函数”章节中“列 flags 支持的选项值”所示。
返回值类型：int

示例：
```
openGauss=# SELECT regexp_count('foobarbaz','b(..)', 5) AS RESULT;
result
--------
1
(1 row)
```
regexp_instr(string text, pattern text [, position int [, occurrence int [, return_opt int [, flags text]]]])
描述：获取满足匹配条件的子串位置（从1开始）。如果没有匹配的子串，则返回0。

参数说明：
- string：用于匹配的源字符串。
- pattern：用于匹配的正则表达式模式串。
- position：可选参数，表示从源字符串的第几个字符开始匹配，默认值为1。
- occurrence：可选参数，表示获取第occurrence个匹配子串的位置，默认值为1。
- return_opt：可选参数，用于控制返回匹配子串的首字符位置还是尾字符位置。取值为0时，返回匹配子串的第一个字符的位置（从1开始计算），取值为大于0的值时，返回匹配子串的尾字符的下一个字符的位置。默认值为0。
- flags：可选参数，包含零个或多个改变函数匹配行为的单字母标记。flags 支持的选项值及含义描述请参见《实验室特性说明》中“C Function > 接口介绍 > 函数”章节中“列 flags 支持的选项值”所示。
返回值类型：int

示例：
```
openGauss=# SELECT regexp_instr('foobarbaz','b(..)', 1, 1, 0) AS RESULT;
result
--------
4
(1 row)

openGauss=# SELECT regexp_instr('foobarbaz','b(..)', 1, 2, 0) AS RESULT;
result
--------
7
(1 row)
```
repeat(string text, number int )
描述：将string重复number次。

返回值类型：text

示例：
1 2 3 4 5

openGauss=# SELECT repeat('Pg', 4); repeat ---------- PgPgPgPg (1 row)
由于数据库内存分配机制限制单次内存分配不可超过1GB，因此number最大值不应超过(1G-x)/lengthb(string) - 1。x为头信息长度，通常大于4字节，其具体值在不同的场景下存在差异。

replace(string text, from text, to text)

描述：把字符串string里出现的所有子字符串from的内容替换成子字符串to的内容。

返回值类型：text

示例：

     
          openGauss=# SELECT replace('abcdefabcdef', 'cd', 'XXX');
    replace     
----------------
 abXXXefabXXXef
(1 row)

replace(string, substring)

描述：删除字符串string里出现的所有子字符串substring的内容。

string类型：text

substring类型：text

返回值类型：text

示例：

     
          openGauss=# SELECT replace('abcdefabcdef', 'cd');
    replace     
----------------
 abefabef
(1 row)

reverse(str)

描述：返回颠倒的字符串。

返回值类型：text

示例：

     
          openGauss=# SELECT reverse('abcde');
 reverse
---------
 edcba
(1 row)

right(str text, n int)

描述：返回字符串中的后n个字符。当n是负值时，返回除前|n|个字符以外的所有字符。

返回值类型：text

示例：

     
          openGauss=# SELECT right('abcde', 2);
 right
-------
 de
(1 row)

openGauss=# SELECT right('abcde', -2);
 right 
-------
 cde
(1 row)

rpad(string text, length int [, fill text])
描述：使用填充字符fill（缺省时为空白），把string填充到length长度。如果string已经比length长则将其从尾部截断。

返回值类型：text

示例：
1 2 3 4 5

openGauss=# SELECT rpad('hi', 5, 'xy'); rpad ------- hixyx (1 row)
rtrim(string text [, characters text])
描述：从字符串string的结尾删除只包含characters中字符（缺省是个空白）的最长的字符串。

返回值类型：text

示例：
1 2 3 4 5

openGauss=# SELECT rtrim('trimxxxx', 'x'); rtrim ------- trim (1 row)
substrb(text,int,int)
描述：提取子字符串，第一个int表示提取的起始位置，第二个表示提取几位字符。

返回值类型：text

示例：
1 2 3 4 5

openGauss=# SELECT substrb('string',2,3); substrb --------- tri (1 row)
substrb(text,int)
描述：提取子字符串，int表示提取的起始位置。

返回值类型：text

示例：
1 2 3 4 5

openGauss=# SELECT substrb('string',2); substrb --------- tring (1 row)
substr(bytea,from,count)
描述：从参数bytea中抽取子字符串。from表示抽取的起始位置，count表示抽取的子字符串长度。

返回值类型：text

示例：
1 2 3 4 5

openGauss=# SELECT substr('string',2,3); substr -------- tri (1 row)

string || string

描述：连接字符串。

返回值类型：text

示例：

     
          openGauss=# SELECT 'MPP'||'DB' AS RESULT;
 result 
--------
 MPPDB
(1 row)

string || non-string或non-string || string

描述：连接字符串和非字符串。

返回值类型：text

示例：

     
          openGauss=# SELECT 'Value: '||42 AS RESULT;
  result   
-----------
 Value: 42
(1 row)

split_part(string text, delimiter text, field int)

描述：根据delimiter分隔string返回生成的第field个子字符串（从出现第一个delimiter的text为基础）。

返回值类型：text

示例：

     
          openGauss=# SELECT split_part('abc~@~def~@~ghi', '~@~', 2);
 split_part
------------
 def
(1 row)

strpos(string, substring)

描述：指定的子字符串的位置。和position(substring in string)一样，不过参数顺序相反。

返回值类型：int

示例：

     
          openGauss=# SELECT strpos('source', 'rc');
 strpos
--------
      4
(1 row)

to_hex(number int or bigint)

描述：把number转换成十六进制表现形式。

返回值类型：text

示例：

     
          openGauss=# SELECT to_hex(2147483647);
  to_hex
----------
 7fffffff
(1 row)

translate(string text, from text, to text)

描述：把在string中包含的任何匹配from中的字符转换为对应的在to中的字符。如果from比to长，删掉在from中出现的额外的字符。

返回值类型：text

示例：

     
          openGauss=# SELECT translate('12345', '143', 'ax');
 translate
-----------
 a2x5
(1 row)

length(string)

描述：获取参数string中字符的数目。

返回值类型：integer

示例：

     
          openGauss=# SELECT length('abcd');
 length 
--------
      4
(1 row)

lengthb(string)

描述：获取参数string中字节的数目。与字符集有关，同样的中文字符，在GBK与UTF8中，返回的字节数不同。

返回值类型：integer

示例：

     
          openGauss=# SELECT lengthb('Chinese');
 lengthb 
---------
       7
(1 row)

substr(string,from)
描述：

从参数string中抽取子字符串。

from表示抽取的起始位置。
- from为0时，按1处理。
- from为正数时，抽取从from到末尾的所有字符。
- from为负数时，抽取字符串的后n个字符，n为from的绝对值。
返回值类型：text

示例：

from为正数时：
1 2 3 4 5

openGauss=# SELECT substr('ABCDEF',2); substr -------- BCDEF (1 row)
from为负数时：
1 2 3 4 5

openGauss=# SELECT substr('ABCDEF',-2); substr -------- EF (1 row)
substr(string,from,count)
描述：

从参数string中抽取子字符串。

from表示抽取的起始位置。

count表示抽取的子字符串长度。
- from为0时，按1处理。
- from为正数时，抽取从from开始的count个字符。
- from为负数时，抽取从倒数第n个开始的count个字符，n为from的绝对值。
- count小于1时，返回null。
返回值类型：text

示例：

from为正数时：
1 2 3 4 5

openGauss=# SELECT substr('ABCDEF',2,2); substr -------- BC (1 row)
from为负数时：
1 2 3 4 5

openGauss=# SELECT substr('ABCDEF',-3,2); substr -------- DE (1 row)
substrb(string,from)
描述：该函数和SUBSTR(string,from)函数功能一致，但是计算单位为字节。

返回值类型：text

示例：
1 2 3 4 5

openGauss=# SELECT substrb('ABCDEF',-2); substrb --------- EF (1 row)
substrb(string,from,count)
描述：该函数和SUBSTR(string,from,count)函数功能一致，但是计算单位为字节。

返回值类型：text

示例：
1 2 3 4 5

openGauss=# SELECT substrb('ABCDEF',2,2); substrb --------- BC (1 row)

trim([leading |trailing |both] [characters] from string)

描述：从字符串string的开头、结尾或两边删除只包含characters中字符（缺省是一个空白）的最长的字符串。

返回值类型：text

示例：

     
          openGauss=# SELECT trim(BOTH 'x' FROM 'xTomxx');
 btrim
-------
 Tom
(1 row)

     
          openGauss=# SELECT trim(LEADING 'x' FROM 'xTomxx');
 ltrim
-------
 Tomxx
(1 row)

     
          openGauss=# SELECT trim(TRAILING 'x' FROM 'xTomxx');
 rtrim
-------
 xTom
(1 row)

rtrim(string [, characters])
描述：从字符串string的结尾删除只包含characters中字符（缺省是个空白）的最长的字符串。

返回值类型：text

示例：
1 2 3 4 5

openGauss=# SELECT rtrim('TRIMxxxx','x'); rtrim ------- TRIM (1 row)
ltrim(string [, characters])
描述：从字符串string的开头删除只包含characters中字符（缺省是一个空白）的最长的字符串。

返回值类型：text

示例：
1 2 3 4 5

openGauss=# SELECT ltrim('xxxxTRIM','x'); ltrim ------- TRIM (1 row)

upper(string)

描述：把字符串转换为大写。

返回值类型：text

示例：

     
          openGauss=# SELECT upper('tom');
 upper
-------
 TOM
(1 row)

lower(string)

描述：把字符串转换为小写。

返回值类型：text

示例：

     
          openGauss=# SELECT lower('TOM');
 lower
-------
 tom
(1 row)

rpad(string varchar, length int [, fill varchar])
描述：使用填充字符fill（缺省时为空白），把string填充到length长度。如果string已经比length长则将其从尾部截断。

length参数在GaussDB中表示字符长度。一个汉字长度计算为一个字符。

返回值类型：text

示例：
1 2 3 4 5

openGauss=# SELECT rpad('hi',5,'xyza'); rpad ------- hixyz (1 row)
1 2 3 4 5

openGauss=# SELECT rpad('hi',5,'abcdefg'); rpad ------- hiabc (1 row)

instr(string,substring[,position,occurrence])

描述：从字符串string的position（缺省时为1）所指的位置开始查找并返回第occurrence（缺省时为1）次出现子串substring的位置的值。

当position为0时，返回0。
当position为负数时，从字符串倒数第n个字符往前逆向搜索。n为position的绝对值。

本函数以字符为计算单位，如一个汉字为一个字符。

返回值类型：integer

示例：

     
          openGauss=# SELECT instr('corporate floor','or', 3);
 instr 
-------
     5
(1 row)

     
          openGauss=# SELECT instr('corporate floor','or',-3,2);
 instr 
-------
     2
(1 row)

initcap(string)

描述：将字符串中的每个单词的首字母转换为大写，其他字母转换为小写。

返回值类型：text

示例：

     
          openGauss=# SELECT initcap('hi THOMAS');
  initcap
-----------
 Hi Thomas
(1 row)

ascii(string)
描述：参数string的第一个字符的ASCII码。

返回值类型：integer

示例：
1 2 3 4 5

openGauss=# SELECT ascii('xyz'); ascii ------- 120 (1 row)

replace(string varchar, search_string varchar, replacement_string varchar)

描述：把字符串string中所有子字符串search_string替换成子字符串replacement_string。

返回值类型：text

示例：

     
          openGauss=# SELECT replace('jack and jue','j','bl');
    replace     
----------------
 black and blue
(1 row)

lpad(string varchar, length int[, repeat_string varchar])

描述：在string的左侧添上一系列的repeat_string（缺省为空白）来组成一个总长度为n的新字符串。

如果string本身的长度比指定的长度length长，则本函数将把string截断并把前面长度为length的字符串内容返回。

返回值类型：varchar

示例：

     
          openGauss=# SELECT lpad('PAGE 1',15,'*.');
      lpad       
-----------------
 *.*.*.*.*PAGE 1
(1 row)

     
          openGauss=# SELECT lpad('hello world',5,'abcd');
 lpad  
-------
 hello
(1 row)

concat(str1,str2)

描述：将字符串str1和str2连接并返回，若str1或str2为NULL时，返回NULL。注意，concat会调用data type的输出函数，返回值不确定，导致优化器在生成计划的时候不能提前计算结果。如果对性能有要求，建议用 || 替代。

在sql_compatibility = 'B'的情况下，参数str1或str2为NULL会导致返回结果为NULL。
concat函数返回值类型为变长类型，和表中数据比较时，会因为拼接结果丢失字符串长度，导致比较结果不相等。

返回值类型：text

示例：

     
          openGauss=# SELECT concat('Hello', ' World!');
    concat    
--------------
 Hello World!
(1 row)
openGauss=# SELECT concat('Hello', NULL);
 concat
--------
 Hello
(1 row)

chr(integer)
描述：给出ASCII码的字符。

返回值类型：varchar

示例：
1 2 3 4 5

openGauss=# SELECT chr(65); chr ----- A (1 row)

concat_ws(sep text, str"any" [, str"any" [, ...] ])

描述：以第一个参数为分隔符，连接第二个以后的所有参数。NULL参数被忽略。

如果第一个参数值是NULL，会导致返回结果为NULL。
如果第一个参数值是空字符串（''），且数据库SQL兼容模式设置为A的情况下，会导致返回结果为NULL。这是因为A兼容模式将''作为NULL处理，避免此类行为，可以将数据库SQL兼容模式改为B、C或者PG。

返回值类型：text

示例：

     
          openGauss=# SELECT concat_ws(',', 'ABCDE', 2, NULL, 22);
 concat_ws
------------
 ABCDE,2,22
(1 row)

nlssort(string text, sort_method text)

描述：以sort_method指定的排序方式返回字符串在该排序模式下的编码值，该编码值可用于排序，其决定了string在这种排序模式下的先后位置。目前支持的sort_method为'nls_sort=schinese_pinyin_m'和'nls_sort=generic_m_ci'。其中，'nls_sort=generic_m_ci'仅支持纯英文不区分大小写排序。

string类型：text

sort_method类型：text

返回值类型：text

示例：

     
          openGauss=# CREATE TABLE test(a text);

openGauss=# INSERT into test(a) values ('abC 不');

openGauss=# insert INTO test(a) VALUES ('abC 啊');

openGauss=# INSERT INTO test(a) VALUES ('abc 啊');

openGauss=# SELECT * FROM test ORDER BY nlssort(a,'nls_sort=schinese_pinyin_m');
   a    
--------
 abc 啊
 abC 啊
 abC 不
(3 rows)

openGauss=# SELECT * FROM test ORDER BY nlssort(a, 'nls_sort=generic_m_ci');
   a    
--------
 abC 啊
 abc 啊
 abC 不
(3 rows)

openGauss=# DROP TABLE test;

convert(string bytea, src_encoding name, dest_encoding name)

描述：以dest_encoding指定的目标编码方式转换字符串string。src_encoding指定源编码方式，在该编码下，string必须是合法的。

返回值类型：bytea

示例：

     
          openGauss=# SELECT convert('text_in_utf8', 'UTF8', 'GBK');
          convert        
----------------------------
 \x746578745f696e5f75746638
(1 row)

如果源编码格式到目标编码格式的转换规则不存在，则字符串不进行任何转换直接返回，如GBK和LATIN1之间的转换规则是不存在的，具体转换规则可以通过查看系统表pg_conversion获得。

示例：

       
            openGauss=# SHOW server_encoding;
 server_encoding 
-----------------
 LATIN1
(1 row)

openGauss=# SELECT convert_from('some text', 'GBK');
 convert_from 
--------------
 some text
(1 row)

db_latin1=# SELECT convert_to('some text', 'GBK');
      convert_to      
----------------------
 \x736f6d652074657874
(1 row)

db_latin1=# SELECT convert('some text', 'GBK', 'LATIN1');
       convert        
----------------------
 \x736f6d652074657874
(1 row)

convert_from(string bytea, src_encoding name)

描述：以数据库的编码方式转换字符串string。

src_encoding指定源编码方式，在该编码下，string必须是合法的。

返回值类型：text

示例：

     
          openGauss=# SELECT convert_from('text_in_utf8', 'UTF8');
 convert_from
--------------
 text_in_utf8
(1 row)

convert_to(string text, dest_encoding name)

描述：将字符串转换为dest_encoding的编码格式。

返回值类型：bytea

示例：

     
          openGauss=# SELECT convert_to('some text', 'UTF8');
      convert_to
----------------------
encode \x736f6d652074657874
(1 row)

format(formatstr text [, str"any" [, ...] ])

描述：格式化字符串。

返回值类型：text

示例：

     
          openGauss=# SELECT format('Hello %s, %1$s', 'World');
       format       
--------------------
 Hello World, World
(1 row)

md5(string)

描述：将string使用MD5加密，并以16进制数作为返回值。

MD5加密算法安全性低，存在安全风险，不建议使用。

返回值类型：text

示例：

     
          openGauss=# SELECT md5('ABC');
               md5                
----------------------------------
 902fbdd2b1df0c4f70b4a5d23525e932
(1 row)

decode(string text, format text)

描述：将二进制数据从文本数据中解码。

返回值类型：bytea

示例：

     
          openGauss=# SELECT decode('MTIzAAE=', 'base64');
    decode    
--------------
 \x3132330001
(1 row)

encode(data bytea, format text)

描述：将二进制数据编码为文本数据。

返回值类型：text

示例：

     
          openGauss=# SELECT encode(E'123\\000\\001', 'base64');
  encode  
----------
 MTIzAAE=
(1 row)

若字符串中存在换行符，如字符串由一个换行符和一个空格组成，在GaussDB中LENGTH和LENGTHB的值为2。
对于CHAR(n) 类型，GaussDB中n是指字符个数。因此，对于多字节编码的字符集， LENGTHB函数返回的长度可能大于n。
GaussDB支持多种类型的数据库，目前有4种，分别是A类型，B类型，C类型以及PG类型。在不指定数据库类型时，数据库默认是A类型，A的词法分析器与另外三种不一样，在A中空字符串会被当作是NULL。所以，当使用A类型的数据库时，假如上述字符操作函数中有空字符串作为参数，会出现没有输出的情况。例如：
```
openGauss=# SELECT translate('12345','123','');
translate  
-----------

(1 row)
```
这是因为内核在调用相应的函数进行处理前，会判断所输入的参数中是否含有NULL，假如有，则不会调用相应的函数，因此会没有输出。而在PG模式下，字符串的处理方式与postgresql保持一致，因此不会有上述问题产生。

父主题： 函数和操作符

上一篇：比较操作符

下一篇：二进制字符串函数和操作符

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

字符处理函数和操作符

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线