本節描述了用於檢查和操作字串值的函數和操作符。
在這個環境中的串包括所有類型character、character varying和text的值。 除非特別說明,這些函數和操作符聲明為接受並返回text類型。 他們將互換接受character varying參數。 在應用函數或操作符之前character類型的值將被轉換為text,結果刪除character值中的任何末尾空格。
SQL 定義了一些字串函數,它們使用關鍵字,而不是逗號來分隔參數。詳情請見 SQL 字串函數和操作符表,本資料庫也提供了這些函數使用正常函數調用文法的版本(見其他字串函數表)。
由於存在從那些資料類型到text的隱式強制措施,在本資料庫 8.3 之前,這些函數也可以接受多種非字串資料型別。這些強制措施在目前的版本中已經被刪除,因為它們常常導致令人驚訝的行為。不過,字串串接操作符(||)仍然接受非字串輸入,只要至少一個輸入是一種字串類型,如 SQL 字串函數和操作符表所示。對於其他情況,如果你需要複製之前的行為,可以為text插入一個顯式強制措施。
SQL字串函數和操作符
串連兩個字串。
|
將非字串輸入轉換為文本,然後將兩個字串串聯在一起。 (非字串輸入不能為數群組類型,因為這將在
|
檢查字串是否在指定的 Unicode 正常化表單中。 可選的
|
返回字串中的位元(8倍於
|
返回字串中的字元數。
|
根據資料庫的語言環境規則,將字串轉換為全部小寫。
|
將字串轉換為指定的Unicode正常化形式。 可選的
|
返回字串的位元組數。
|
返回字串中的位元組數。 由於此版本的函數直接接受
|
替換
|
返回指定的
|
如果已指定,提取
|
提取匹配POSIXRegex的子字串。
|
提取匹配 SQL Regex的字串。
|
從
|
這是一個非標準的
|
根據資料庫的定位規則,將字串轉換為所有大寫。
|
還有額外的串操作函數可以用,它們在其他字串函數表中列出。它們有些在內部用於實現 SQL 字串函數和操作符表列出的 SQL 標準字串函數。
其他字串函數
返回參數的第一個字元的數字代碼。在UTF8編碼中,返回該字元的Unicode代碼點。 在其他多位元組編碼中,該參數必須是一個ASCII字元。
|
從
|
返回給定代碼的字元。在UTF8編碼中該參數被視作一個Unicode代碼點。 在其他多位元組編碼中該參數必須指定一個ASCII字元。
|
串連所有參數的文本表示。空參數被忽略。
|
用分隔字元串連除第一個參數外的所有參數。第一個參數用作分隔字元字串,不應為NULL。其他NULL參數將被忽略。
|
根據格式字串對參數進行格式化。 這個函數類似於C函數
|
將每個單詞的第一個字母轉換為大寫,其餘字母轉換為小寫。單詞是由非字母數字字元分隔的字母數字字元序列。
|
以字串返回第一個
|
返回字串中的字元數。
|
將
|
從
|
計算參數的 MD5 hash ,結果以十六進位形式寫入。
|
將
|
返回當前用戶端編碼名稱。
|
返回適合引用的給定字串,作為SQL語句字串中的標識符。 只有在必要的情況下才添加引號(例如,如果字串包含非標識符字元或將被大小寫摺疊)。 嵌入的引號被適當地加雙引號。
|
返回在SQL語句字串中適當引用的給定字串,用作字串文字使用。 嵌入式單引號和反斜線適當的翻倍(轉雙引號或雙斜線)。 請注意,
|
將給定的值轉換為文本,然後將其作為字面量引用。 內嵌的單引號和反斜線被適當地翻倍。
|
返回在SQL語句字串中適當引用的給定字串文字;或者,如果參數為null,則返回
|
將給定值轉換為文本,然後將其作為字面量引用;或者,如果參數為null,則返回
|
返回從POSIXRegex到
|
返回通過將POSIXRegex與
|
替換匹配POSIXRegex的子字串。
|
使用POSIXRegex作為分隔字元拆分
|
使用POSIXRegex作為分隔字元拆分
|
重複
|
將
|
顛倒字串中字元的順序。
|
返回字串中的最後
|
擴充
|
從
|
在
|
返回在
|
提取
|
如果
|
將
|
將數字轉換為其相應的十六進位表示形式。
|
將
|
concat、concat_ws和format函數是可變的,因此可以把要串接或格式化的值作為一個標記了VARIADIC關鍵字的數組進行傳遞。 數組的元素被當作函數的獨立普通參數一樣處理。如果可變數組參數為 NULL,concat和concat_ws返回 NULL,但format把 NULL 當作一個零元素數組。
format
函數format根據一個格式字串產生格式化的輸出,其形式類似於 C 函數sprintf。
format(formatstr text [, formatarg "any" [, ...] ])formatstr是一個格式字串,它指定了結果應該如何被格式化。格式字串中的文本被直接複製到結果中,除了使用格式說明符的地方。格式說明符在字串中扮演著預留位置的角色,它定義後續的函數參數如何被格式化及插入到結果中。每一個formatarg參數會被根據其資料類型的常規輸出規則轉換為文本,並接著根據格式說明符被格式化和插入到結果字串中。
格式說明符由一個%字元開始並且有這樣的形式
%[position][flags][width]type其中的各組件域是:
position(可選)一個形式為n``$的字串,其中n是要列印的參數的索引。索引 1 表示formatstr之後的第一個參數。如果position被忽略,預設會使用序列中的下一個參數。
flags(可選)控制格式說明符的輸出如何被格式化的附加選項。當前唯一支援的標誌是一個負號(-),它將導致格式說明符的輸出會被靠左對齊(left-justified)。除非width域也被指定,否者這個域不會產生任何效果。
width(可選)指定用於顯示格式說明符輸出的最小字元數。輸出將被在左部或右部(取決於-標誌)用空格填充以保證充滿該寬度。太小的寬度設定不會導致輸出被截斷,但是會被簡單地忽略。寬度可以使用下列形式之一指定:一個正整數;一個星號()表示使用下一個函數參數作為寬度;或者一個形式為```n$的字串表示使用第n`個函數參數作為寬度。
如果寬度來自於一個函數參數,則參數在被格式說明符的值使用之前就被消耗掉了。如果寬度參數是負值,結果會在長度為abs(width)的域中被靠左對齊(如果-標誌被指定)。
type(必需)格式轉換的類型,用於產生格式說明符的輸出。支援下面的類型:
s將參數值格式化為一個簡單字串。一個控制被視為一個Null 字元串。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(E'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,本資料庫的format函數允許將帶有或者不帶有position域的格式說明符被混在同一個格式字串中。一個不帶有position域的格式說明符總是使用最後一個被消耗的參數的下一個參數。另外,format函數不要求所有函數參數都被用在格式字串中。例如:
SELECT format('Testing %3$s, %2$s, %s', 'one', 'two', 'three');
結果:Testing three, two, three對於安全地構造動態 SQL 陳述式,%I和%L格式說明符特別有用。
NLS_UPPER
描述
該函數將字串中英文字母全部轉為大寫。
文法
NLS_UPPER(char [, 'nlsparam' ])參數
參數 | 說明 |
char | 指定要轉換的字串。字串類型可為 |
傳回型別
返回與char相同的類型資料。
樣本
select NLS_UPPER('aaa BBB CcC') FROM DUAL;
nls_upper
-------------
AAA BBB CCCNLSSORT
描述
該函數用於返回排序之後的字串。
文法
NLSSORT(char [, 'nlsparam' ])參數
參數 | 說明 |
char | 指定要排序的字串。字串類型可為 |
nlsparam | 指定返回字串的排序方式,為可選項。 |
傳回型別
返回與c相同的類型資料。
樣本
CREATE TABLE test (name VARCHAR2(15));
INSERT INTO test VALUES ('ccc');
INSERT INTO test VALUES ('bbb');
INSERT INTO test VALUES ('aaa');
SELECT * FROM test ORDER BY name;
name
-----------
Gaardiner
Gaasten
Gaberd
SELECT * FROM test ORDER BY NLSSORT(name, 'NLS_SORT = Danish');
name
-----------
Gaberd
Gaardiner
GaastenREGEXP_INSTR
描述
該函數作用是返回Regex匹配值在源字串中的位置。
文法
REGEXP_INSTR (source_char, pattern[, position[, occurrence[, return_opt[, match_param[, subexpr]]]]])參數
參數 | 說明 |
source_char | 指定用作搜尋值的字元運算式,資料類型可為 |
pattern | 指定Regex截取規則。它通常是一個文本文字,字元類型可為 |
position | 指定開始Regex匹配的起始位置,取值是一個正整數,為可選項。預設值是 1,表示從第一個字元開始搜尋 |
occurrence | 指定 |
return_opt | 指定返回出現匹配值位置選項,為可選項。預設值為
|
match_param | 指定更改Regex預設匹配方式,為可選項。是資料類型
|
subexpr |
|
傳回型別
返回NUMBER類型資料
樣本
SELECT regexp_instr('abcdefghi', 'd.f') FROM DUAL;
regexp_instr
--------------
4INSTR
描述
該函數在一個字串中搜尋指定的字元,返回傳現指定的字元的位置。多位元組字元(漢字、全形符等)按 1 個字元計算。
文法
INSTR(char1,char2[,i[,j]])參數
參數 | 說明 |
char1 | 被搜尋的字串。字串類型可以為 |
char2 | 指定要搜尋的字串。字串類型可以為 |
i | 搜尋的開始位置,預設值為 |
j |
|
傳回型別
返回NUMBER類型資料
樣本
SELECT INSTR('PolarDB-PG','P',1,2) "INSTR" FROM DUAL;
INSTR
-------
9TRIM
描述
該函數用來刪除一個字串的開頭或結尾(或兩者)的字元。
trim_character和trim_source都可以是VARCHAR2或任何可以隱式轉換為 VARCHAR2 的資料類型。如果函數傳回值的資料類型為VARCHAR2,則該值的最大長度為trim_source。
文法
TRIM([{{ LEADING | TRAILING | BOTH }[ trim_character ]|trim_character }FROM] trim_source)參數
參數 | 說明 |
LEADING | TRAILING | BOTH | 指定刪除字元的位置。
|
trim_character | 刪除的字元,只能是單個字元。 如果未指定 |
trim_source | 需要被刪除字元的字串。 如果僅指定 |
傳回型別
如果
trim_source為CHAR、VARCHAR2資料類型,則函數返回VARCHAR2資料類型。如果
trim_source為NCHAR、NVARCHAR2資料類型,則函數返回NVARCHAR2資料類型。如果
trim_source為CLOB資料類型,則函數返回CLOB資料類型。如果
trim_source或trim_character為NULL,則TRIM函數返回NULL。
樣本
SELECT trim(both 'x' from 'x!@#$x') FROM DUAL;
btrim
-------
!@#$TREAT
描述
該函數用於更改運算式的宣告類型,必須對類型具有EXECUTE對象許可權才能使用此函數。
類型必須是已聲明的expr類型的某個超類型或子類型。如果最具體的expr類型是type(或某個子類型),則TREAT返回expr。如果expr的最特定類型不是類型(或某個類型的子類型),則TREAT返回NULL。
只有當聲明的expr類型為REF類型時,才能指定REF。
如果聲明的expr類型是expr源類型的REF,則類型必須是expr的源類型的某個子類型或超類型。如果DEREF(expr)的最特定類型是類型(或類型的子類型),則TREAT返回expr。如果DEREF(expr)的最特定類型不是類型(或類型的子類型),則TREAT返回NULL。
此函數不直接支援CLOB資料。但是,CLOB可以通過隱式資料轉換作為參數傳入。
文法
TREAT( expr AS [ REF ] [ schema. ]type)參數
參數 | 說明 |
expr | 字串類型可為 |
REF | 可選,指定的REF,只有在expr為REF類型時才可以指定 |
schema | 可選,指定type的schema |
type | 指定的宣告類型 |
傳回型別
返回char類型資料
樣本
SELECT name, TREAT(VALUE(p) AS employee_t).salary salary FROM persons p;
NAME SALARY
------------------------- ----------
Bob
Joe 100000
Tim 1000SOUNDEX
描述
該函數用於返回包含char的發音表示的字串,使用此功能可以擷取英語中拼字不同但發音相似的單詞。
文法
SOUNDEX(char)參數
參數 | 說明 |
char | 字串類型可為 |
傳回型別
返回char類型資料
樣本
create table test(c varchar(100));
insert into test values('Smith');
select c from test where SOUNDEX(c) = SOUNDEX('SMYTHE');
c
-------
SmithREGEEXP_SUBSTR
描述
該函數允許使用Regex搜尋字串並返回匹配字串,擴充了 SUBSTR函數的功能。 該函數類似於 REGEXP_INSTR,但它不返回子字串的位置,而是返回子字串。如果僅需要匹配字串的內容,但不需要返回其在源字串中的位置,則此函數很適用。
文法
REGEXP_SUBSTR(source_char, pattern
[, position [, occurrence [, match_param [, subexpr] ] ] ]
)參數
參數 | 說明 |
source_char | 指定用作搜尋值的字元運算式,資料類型可以為 |
pattern | 指定Regex截取規則。它通常是一個文本字面量,字元類型可以為 |
position | 指定開始Regex匹配的起始位置,取值是一個正整數,為可選項。預設值是1,表示從第一個字元開始搜尋 |
occurrence | 指定 |
match_param | 指定更改Regex預設匹配方式,為可選項。是資料類型
|
subexpr | 指示 |
傳回型別
返回與參數source_char相同的 VARCHAR2或 CLOB資料類型。
樣本
SELECT REGEXP_SUBSTR('500 Oracle Parkway, Redwood Shores, CA',',[^,]+,') "REGEXPR_SUBSTR" FROM DUAL;
REGEXPR_SUBSTR
-------------------
, Redwood Shores,
SELECT REGEXP_SUBSTR('http://www.oracle.com/products','http://([[:alnum:]]+\.?){3,4}/?') "REGEXP_SUBSTR" FROM DUAL;
REGEXP_SUBSTR
------------------------
http://www.oracle.com/NLS_LOWER
描述
該函數將字串中英文字母全部轉為小寫。
文法
NLS_LOWER(char [, 'nlsparam' ])參數
參數 | 說明 |
char | 指定要轉換的字串。字串類型可為 |
傳回型別
返回與char相同的類型資料。
樣本
select NLS_LOWER('aaa BBB CcC') FROM DUAL;
nls_lower
-------------
aaa bbb cccNLS_INTCAP
描述
該函數返回字串並將字串中每個單詞的首字母大寫,其他字母小寫。單詞由空格或非字母數字字元分隔。
文法
NLS_INITCAP(c)參數
參數 | 說明 |
c | 字串類型可為 |
傳回型別
返回char類型資料
樣本
select INITCAP('aaa BBB CcC') FROM DUAL;
initcap
-------------
Aaa Bbb Ccc