ASCII(str)

傳回字串 str 最左邊字元的數值。如果 str 是空字串，則傳回 0。如果 str 是 NULL，則傳回 NULL。ASCII() 適用於 8 位元字元。

mysql> SELECT ASCII('2');
        -> 50
mysql> SELECT ASCII(2);
        -> 50
mysql> SELECT ASCII('dx');
        -> 100

另請參閱 ORD() 函數。

BIN(N)

傳回一個字串，表示 N 的二進位值。N 是一個 longlong (BIGINT) 數字。這等同於 CONV(N,10,2)。如果 N 為 NULL，則傳回 NULL。

mysql> SELECT BIN(12);
        -> '1100'

BIT_LENGTH(str)

傳回字串 str 的位元長度。如果 str 為 NULL，則傳回 NULL。

mysql> SELECT BIT_LENGTH('text');
        -> 32

CHAR(N,... [USING charset_name])

CHAR() 將每個引數 N 解譯為整數，並傳回一個字串，該字串由這些整數的程式碼值所給定的字元組成。NULL 值會被跳過。

mysql> SELECT CHAR(77,121,83,81,'76');
+--------------------------------------------------+
| CHAR(77,121,83,81,'76')                          |
+--------------------------------------------------+
| 0x4D7953514C                                     |
+--------------------------------------------------+
1 row in set (0.00 sec)

mysql> SELECT CHAR(77,77.3,'77.3');
+--------------------------------------------+
| CHAR(77,77.3,'77.3')                       |
+--------------------------------------------+
| 0x4D4D4D                                   |
+--------------------------------------------+
1 row in set (0.00 sec)

預設情況下，CHAR() 傳回二進位字串。若要產生以指定字元集表示的字串，請使用選用的 USING 子句。

mysql> SELECT CHAR(77,121,83,81,'76' USING utf8mb4);
+---------------------------------------+
| CHAR(77,121,83,81,'76' USING utf8mb4) |
+---------------------------------------+
| MySQL                                 |
+---------------------------------------+
1 row in set (0.00 sec)

mysql> SELECT CHAR(77,77.3,'77.3' USING utf8mb4);
+------------------------------------+
| CHAR(77,77.3,'77.3' USING utf8mb4) |
+------------------------------------+
| MMM                                |
+------------------------------------+
1 row in set, 1 warning (0.00 sec)

mysql> SHOW WARNINGS;
+---------+------+-------------------------------------------+
| Level   | Code | Message                                   |
+---------+------+-------------------------------------------+
| Warning | 1292 | Truncated incorrect INTEGER value: '77.3' |
+---------+------+-------------------------------------------+
1 row in set (0.00 sec)

如果給定了 USING，且結果字串對於指定的字元集而言無效，則會發出警告。此外，如果啟用了嚴格 SQL 模式，則 CHAR() 的結果會變成 NULL。

如果從 mysql 用戶端內呼叫 CHAR()，則二進位字串會使用十六進位表示法顯示，具體取決於 --binary-as-hex 的值。如需該選項的詳細資訊，請參閱第 6.5.1 節，「mysql — MySQL 命令列用戶端」。

CHAR() 大於 255 的引數會轉換為多個結果位元組。例如，CHAR(256) 等同於 CHAR(1,0)，而 CHAR(256*256) 等同於 CHAR(1,0,0)。

mysql> SELECT HEX(CHAR(1,0)), HEX(CHAR(256));
+----------------+----------------+
| HEX(CHAR(1,0)) | HEX(CHAR(256)) |
+----------------+----------------+
| 0100           | 0100           |
+----------------+----------------+
1 row in set (0.00 sec)

mysql> SELECT HEX(CHAR(1,0,0)), HEX(CHAR(256*256));
+------------------+--------------------+
| HEX(CHAR(1,0,0)) | HEX(CHAR(256*256)) |
+------------------+--------------------+
| 010000           | 010000             |
+------------------+--------------------+
1 row in set (0.00 sec)

CHAR_LENGTH(str)

傳回字串 str 的長度，以程式碼點測量。多位元組字元計為單一程式碼點。這表示對於包含兩個 3 位元組字元的字串，LENGTH() 傳回 6，而 CHAR_LENGTH() 則傳回 2，如下所示：

mysql> SET @dolphin:='海豚';
Query OK, 0 rows affected (0.01 sec)

mysql> SELECT LENGTH(@dolphin), CHAR_LENGTH(@dolphin);
+------------------+-----------------------+
| LENGTH(@dolphin) | CHAR_LENGTH(@dolphin) |
+------------------+-----------------------+
|                6 |                     2 |
+------------------+-----------------------+
1 row in set (0.00 sec)

如果 str 為 NULL，則 CHAR_LENGTH() 傳回 NULL。

CHARACTER_LENGTH(str)

CHARACTER_LENGTH() 是 CHAR_LENGTH() 的同義詞。

CONCAT(str1,str2,...)

傳回串連引數所產生的字串。可以有一個或多個引數。如果所有引數都是非二進位字串，則結果為非二進位字串。如果引數包含任何二進位字串，則結果為二進位字串。數值引數會轉換為其對應的非二進位字串形式。

如果任何引數為 NULL，則 CONCAT() 傳回 NULL。

mysql> SELECT CONCAT('My', 'S', 'QL');
        -> 'MySQL'
mysql> SELECT CONCAT('My', NULL, 'QL');
        -> NULL
mysql> SELECT CONCAT(14.3);
        -> '14.3'

對於加上引號的字串，可以透過將字串彼此相鄰放置來執行串連。

mysql> SELECT 'My' 'S' 'QL';
        -> 'MySQL'

如果從 mysql 用戶端內呼叫 CONCAT()，則二進位字串結果會使用十六進位表示法顯示，具體取決於 --binary-as-hex 的值。如需該選項的詳細資訊，請參閱第 6.5.1 節，「mysql — MySQL 命令列用戶端」。

CONCAT_WS(separator,str1,str2,...)

CONCAT_WS() 代表 Concatenate With Separator，它是 CONCAT() 的特殊形式。第一個引數是其餘引數的分隔符號。分隔符號會新增在要串連的字串之間。分隔符號可以是字串，其餘引數也可以是字串。如果分隔符號為 NULL，則結果為 NULL。

mysql> SELECT CONCAT_WS(',', 'First name', 'Second name', 'Last Name');
        -> 'First name,Second name,Last Name'
mysql> SELECT CONCAT_WS(',', 'First name', NULL, 'Last Name');
        -> 'First name,Last Name'

CONCAT_WS() 不會跳過空字串。但是，它會跳過分隔符號引數之後的任何 NULL 值。

ELT(N,str1,str2,str3,...)

如果 N = 1，則 ELT() 傳回字串清單的第 N 個元素：str1；如果 N = 2，則傳回 str2，依此類推。如果 N 小於 1、大於引數的數量或為 NULL，則傳回 NULL。ELT() 是 FIELD() 的補數。

mysql> SELECT ELT(1, 'Aa', 'Bb', 'Cc', 'Dd');
        -> 'Aa'
mysql> SELECT ELT(4, 'Aa', 'Bb', 'Cc', 'Dd');
        -> 'Dd'

EXPORT_SET(bits,on,off[,separator[,number_of_bits]])

傳回一個字串，對於值 bits 中設定的每個位元，您會得到一個 on 字串，而對於值中未設定的每個位元，您會得到一個 off 字串。會從右到左 (從低位到高位) 檢查 bits 中的位元。字串會從左到右新增到結果中，並以 separator 字串 (預設為逗號字元 ,) 分隔。檢查的位元數由 number_of_bits 給定，如果未指定，則預設為 64。number_of_bits 如果大於 64，則會無訊息地截斷為 64。它會被視為不帶正負號的整數，因此值 -1 實際上與 64 相同。

mysql> SELECT EXPORT_SET(5,'Y','N',',',4);
        -> 'Y,N,Y,N'
mysql> SELECT EXPORT_SET(6,'1','0',',',10);
        -> '0,1,1,0,0,0,0,0,0,0'

FIELD(str,str1,str2,str3,...)

傳回 str 在 str1、str2、str3、... 清單中的索引 (位置)。如果找不到 str，則傳回 0。

如果 FIELD() 的所有引數都是字串，則所有引數都會作為字串進行比較。如果所有引數都是數字，則會作為數字進行比較。否則，引數會作為雙精度數進行比較。

如果 str 為 NULL，則傳回值為 0，因為 NULL 無法與任何值進行相等比較。FIELD() 是 ELT() 的補數。

mysql> SELECT FIELD('Bb', 'Aa', 'Bb', 'Cc', 'Dd', 'Ff');
        -> 2
mysql> SELECT FIELD('Gg', 'Aa', 'Bb', 'Cc', 'Dd', 'Ff');
        -> 0

FIND_IN_SET(str,strlist)

如果字串 str 在由 N 個子字串組成的字串清單 strlist 中，則傳回 1 到 N 範圍內的值。字串清單是由逗號 (,) 字元分隔的子字串組成的字串。如果第一個引數是常數字串，而第二個引數是 SET 類型的欄，則 FIND_IN_SET() 函式會經過最佳化，以使用位元算術。如果 str 不在 strlist 中，或如果 strlist 是空字串，則傳回 0。如果任一引數為 NULL，則傳回 NULL。如果第一個引數包含逗號 (,) 字元，則此函式無法正常運作。

mysql> SELECT FIND_IN_SET('b','a,b,c,d');
        -> 2

FORMAT(X,D[,locale])

將數字 X 格式化為類似 '#,###,###.##' 的格式，四捨五入到 D 個小數位數，並以字串形式傳回結果。如果 D 為 0，則結果沒有小數點或小數部分。如果 X 或 D 為 NULL，則該函式傳回 NULL。

選用的第三個參數允許指定用於結果數字小數點、千位分隔符號和分隔符號之間分組的地區設定。允許的地區設定值與 lc_time_names 系統變數的合法值相同 (請參閱第 12.16 節，「MySQL 伺服器地區設定支援」)。如果地區設定為 NULL 或未指定，則預設地區設定為 'en_US'。

mysql> SELECT FORMAT(12332.123456, 4);
        -> '12,332.1235'
mysql> SELECT FORMAT(12332.1,4);
        -> '12,332.1000'
mysql> SELECT FORMAT(12332.2,0);
        -> '12,332'
mysql> SELECT FORMAT(12332.2,2,'de_DE');
        -> '12.332,20'

FROM_BASE64(str)

採用使用 TO_BASE64() 使用的 Base-64 編碼規則編碼的字串，並以二進位字串形式傳回解碼結果。如果引數為 NULL 或不是有效的 Base-64 字串，則結果為 NULL。如需有關編碼和解碼規則的詳細資訊，請參閱 TO_BASE64() 的說明。

mysql> SELECT TO_BASE64('abc'), FROM_BASE64(TO_BASE64('abc'));
        -> 'JWJj', 'abc'

如果從 mysql 用戶端內呼叫 FROM_BASE64()，則二進位字串會使用十六進位表示法顯示。您可以透過在啟動 mysql 用戶端時，將 --binary-as-hex 的值設定為 0 來停用此行為。如需該選項的詳細資訊，請參閱第 6.5.1 節，「mysql — MySQL 命令列用戶端」。

HEX(str), HEX(N)

對於字串引數 str，HEX() 會傳回 str 的十六進位字串表示法，其中 str 中每個字元的每個位元組都會轉換為兩個十六進位數字。(因此，多位元組字元會變成兩個以上的數字。)此作業的反向作業由 UNHEX() 函式執行。

對於數值參數 N，HEX() 會回傳一個十六進位字串，此字串代表將 N 視為 longlong (BIGINT) 數字的值。這等同於 CONV(N,10,16)。此操作的反向操作由 CONV(HEX(N),16,10) 執行。

對於 NULL 參數，此函數回傳 NULL。

mysql> SELECT X'616263', HEX('abc'), UNHEX(HEX('abc'));
        -> 'abc', 616263, 'abc'
mysql> SELECT HEX(255), CONV(HEX(255),16,10);
        -> 'FF', 255

INSERT(str,pos,len,newstr)

回傳字串 str，其中從位置 pos 開始，長度為 len 個字元的子字串會被字串 newstr 取代。如果 pos 不在字串長度範圍內，則回傳原始字串。如果 len 不在字串剩餘長度範圍內，則會從位置 pos 開始取代字串的其餘部分。如果有任何參數為 NULL，則回傳 NULL。

mysql> SELECT INSERT('Quadratic', 3, 4, 'What');
        -> 'QuWhattic'
mysql> SELECT INSERT('Quadratic', -1, 4, 'What');
        -> 'Quadratic'
mysql> SELECT INSERT('Quadratic', 3, 100, 'What');
        -> 'QuWhat'

此函數是多位元組安全的。

INSTR(str,substr)

回傳子字串 substr 在字串 str 中首次出現的位置。這與 LOCATE() 的雙參數形式相同，只是參數的順序相反。

mysql> SELECT INSTR('foobarbar', 'bar');
        -> 4
mysql> SELECT INSTR('xbar', 'foobar');
        -> 0

此函數是多位元組安全的，並且只有在至少一個參數是二進位字串時才會區分大小寫。如果任一參數為 NULL，此函數會回傳 NULL。

LCASE(str)

LCASE() 是 LOWER() 的同義詞。

當儲存檢視表的定義時，檢視表中所使用的 LCASE() 會被重寫為 LOWER()。（錯誤 #12844279）

LEFT(str,len)

回傳字串 str 最左邊的 len 個字元，如果任何參數為 NULL，則回傳 NULL。

mysql> SELECT LEFT('foobarbar', 5);
        -> 'fooba'

此函數是多位元組安全的。

LENGTH(str)

回傳字串 str 的長度，以位元組為單位測量。一個多位元組字元算作多個位元組。這表示對於包含五個 2 位元組字元的字串，LENGTH() 會回傳 10，而 CHAR_LENGTH() 會回傳 5。如果 str 為 NULL，則回傳 NULL。

mysql> SELECT LENGTH('text');
        -> 4

LOAD_FILE(file_name)

讀取檔案並將檔案內容回傳為字串。要使用此函數，檔案必須位於伺服器主機上，您必須指定檔案的完整路徑名稱，並且您必須具有 FILE 權限。該檔案必須可由伺服器讀取，並且其大小小於 max_allowed_packet 個位元組。如果 secure_file_priv 系統變數設定為非空目錄名稱，則要載入的檔案必須位於該目錄中。

如果該檔案不存在或因不滿足上述其中一個條件而無法讀取，則該函數會回傳 NULL。

character_set_filesystem 系統變數控制作為文字字串給定的檔案名稱的解譯。

mysql> UPDATE t
            SET blob_col=LOAD_FILE('/tmp/picture')
            WHERE id=1;

LOCATE(substr,str)，LOCATE(substr,str,pos)

第一個語法會回傳子字串 substr 在字串 str 中首次出現的位置。第二個語法會回傳從位置 pos 開始，子字串 substr 在字串 str 中首次出現的位置。如果 substr 不在 str 中，則回傳 0。如果任何參數為 NULL，則回傳 NULL。

mysql> SELECT LOCATE('bar', 'foobarbar');
        -> 4
mysql> SELECT LOCATE('xbar', 'foobar');
        -> 0
mysql> SELECT LOCATE('bar', 'foobarbar', 5);
        -> 7

此函數是多位元組安全的，並且只有在至少一個參數是二進位字串時才會區分大小寫。

LOWER(str)

根據目前的字元集對應表，回傳字串 str，其中所有字元都已變更為小寫，如果 str 為 NULL，則回傳 NULL。預設字元集為 utf8mb4。

mysql> SELECT LOWER('QUADRATICALLY');
        -> 'quadratically'

當套用至二進位字串 (BINARY、VARBINARY、BLOB) 時，LOWER()（和 UPPER()）無效。若要對二進位字串執行字母大小寫轉換，請先使用適用於字串中儲存之資料的字元集，將其轉換為非二進位字串

mysql> SET @str = BINARY 'New York';
mysql> SELECT LOWER(@str), LOWER(CONVERT(@str USING utf8mb4));
+-------------+------------------------------------+
| LOWER(@str) | LOWER(CONVERT(@str USING utf8mb4)) |
+-------------+------------------------------------+
| New York    | new york                           |
+-------------+------------------------------------+

對於 Unicode 字元集的排序規則，如果排序規則名稱中有 Unicode 校對演算法 (UCA) 版本，LOWER() 和 UPPER() 會根據該版本運作，如果未指定版本，則根據 UCA 4.0.0 運作。例如，utf8mb4_0900_ai_ci 和 utf8mb3_unicode_520_ci 分別根據 UCA 9.0.0 和 5.2.0 運作，而 utf8mb3_unicode_ci 根據 UCA 4.0.0 運作。請參閱 第 12.10.1 節「Unicode 字元集」。

此函數是多位元組安全的。

檢視表中使用的 LCASE() 會被重寫為 LOWER()。

LPAD(str,len,padstr)

回傳字串 str，使用字串 padstr 在左側填補至長度為 len 個字元。如果 str 長於 len，則傳回值會縮短為 len 個字元。

mysql> SELECT LPAD('hi',4,'??');
        -> '??hi'
mysql> SELECT LPAD('hi',1,'??');
        -> 'h'

如果其任何引數為 NULL，則回傳 NULL。

LTRIM(str)

回傳已移除前導空白字元的字串 str。如果 str 為 NULL，則回傳 NULL。

mysql> SELECT LTRIM('  barbar');
        -> 'barbar'

此函數是多位元組安全的。

MAKE_SET(bits,str1,str2,...)

回傳一個設定值（一個包含由 , 字元分隔的子字串的字串），該設定值包含在 bits 中設定了對應位元的字串。str1 對應於位元 0，str2 對應於位元 1，依此類推。str1、str2、... 中的 NULL 值不會附加至結果。

mysql> SELECT MAKE_SET(1,'a','b','c');
        -> 'a'
mysql> SELECT MAKE_SET(1 | 4,'hello','nice','world');
        -> 'hello,world'
mysql> SELECT MAKE_SET(1 | 4,'hello','nice',NULL,'world');
        -> 'hello'
mysql> SELECT MAKE_SET(0,'a','b','c');
        -> ''

MID(str,pos,len)

MID(str,pos,len) 是 SUBSTRING(str,pos,len) 的同義詞。

OCT(N)

回傳 N 的八進位值的字串表示法，其中 N 是一個 longlong (BIGINT) 數字。這等同於 CONV(N,10,8)。如果 N 為 NULL，則回傳 NULL。

mysql> SELECT OCT(12);
        -> '14'

OCTET_LENGTH(str)

OCTET_LENGTH() 是 LENGTH() 的同義詞。

ORD(str)

如果字串 str 最左邊的字元是多位元組字元，則使用此公式從其組成位元組的數值計算該字元的代碼

  (1st byte code)
+ (2nd byte code * 256)
+ (3rd byte code * 256^2) ...

如果最左邊的字元不是多位元組字元，則 ORD() 會傳回與 ASCII() 函數相同的值。如果 str 為 NULL，則函數會回傳 NULL。

mysql> SELECT ORD('2');
        -> 50

POSITION(substr IN str)

POSITION(substr IN str) 是 LOCATE(substr,str) 的同義詞。

QUOTE(str)

將字串加上引號，以產生可用於 SQL 陳述式中，經過適當跳脫處理的資料值。傳回的字串會以單引號括住，並且每個反斜線 (\)、單引號 (')、ASCII NUL 和 Control+Z 的實例前面都會加上反斜線。如果引數為 NULL，則傳回值為單字 「NULL」，不包含外面的單引號。

mysql> SELECT QUOTE('Don\'t!');
        -> 'Don\'t!'
mysql> SELECT QUOTE(NULL);
        -> NULL

作為比較，請參閱第 11.1.1 節， 「字串文字」以及mysql_real_escape_string_quote()中，字串文字和 C API 內的引號規則。

REPEAT(str,count)

傳回一個由字串 str 重複 count 次所組成的字串。如果 count 小於 1，則傳回空字串。如果 str 或 count 為 NULL，則傳回 NULL。

mysql> SELECT REPEAT('MySQL', 3);
        -> 'MySQLMySQLMySQL'

REPLACE(str,from_str,to_str)

傳回字串 str，其中所有出現的字串 from_str 都會被字串 to_str 取代。REPLACE() 在搜尋 from_str 時會執行區分大小寫的匹配。

mysql> SELECT REPLACE('www.mysql.com', 'w', 'Ww');
        -> 'WwWwWw.mysql.com'

此函數是多位元組安全。如果任何引數為 NULL，則傳回 NULL。

REVERSE(str)

傳回字元順序反轉的字串 str，如果 str 為 NULL，則傳回 NULL。

mysql> SELECT REVERSE('abc');
        -> 'cba'

此函數是多位元組安全的。

RIGHT(str,len)

傳回字串 str 最右邊的 len 個字元，如果任何引數為 NULL，則傳回 NULL。

mysql> SELECT RIGHT('foobarbar', 4);
        -> 'rbar'

此函數是多位元組安全的。

RPAD(str,len,padstr)

傳回字串 str，在右邊使用字串 padstr 填補到長度為 len 個字元。如果 str 比 len 長，則傳回值會縮短為 len 個字元。如果 str、padstr 或 len 為 NULL，則此函數會傳回 NULL。

mysql> SELECT RPAD('hi',5,'?');
        -> 'hi???'
mysql> SELECT RPAD('hi',1,'?');
        -> 'h'

此函數是多位元組安全的。

RTRIM(str)

傳回移除尾隨空白字元的字串 str。

mysql> SELECT RTRIM('barbar   ');
        -> 'barbar'

此函數是多位元組安全，如果 str 為 NULL，則傳回 NULL。

SOUNDEX(str)

從 str 傳回一個 soundex 字串，如果 str 為 NULL，則傳回 NULL。兩個聽起來幾乎相同的字串應該具有相同的 soundex 字串。標準 soundex 字串長度為四個字元，但 SOUNDEX() 函數會傳回任意長度的字串。您可以使用結果上的 SUBSTRING() 來取得標準 soundex 字串。會忽略 str 中所有非字母字元。A-Z 範圍之外的所有國際字母字元都視為母音。

mysql> SELECT SOUNDEX('Hello');
        -> 'H400'
mysql> SELECT SOUNDEX('Quadratically');
        -> 'Q36324'

expr1 SOUNDS LIKE expr2

這與 SOUNDEX(expr1) = SOUNDEX(expr2) 相同。

SPACE(N)

傳回一個由 N 個空白字元組成的字串，如果 N 為 NULL，則傳回 NULL。

mysql> SELECT SPACE(6);
        -> '      '

SUBSTR(str,pos)、SUBSTR(str FROM pos)、SUBSTR(str,pos,len)、SUBSTR(str FROM pos FOR len)

SUBSTR() 是 SUBSTRING() 的同義詞。

SUBSTRING(str,pos)、SUBSTRING(str FROM pos)、SUBSTRING(str,pos,len)、SUBSTRING(str FROM pos FOR len)

不含 len 引數的形式，會傳回從字串 str 中，從位置 pos 開始的子字串。含有 len 引數的形式，會傳回從字串 str 中，從位置 pos 開始，長度為 len 個字元的子字串。使用 FROM 的形式是標準 SQL 語法。也可以為 pos 使用負值。在這種情況下，子字串的開頭是從字串結尾算起 pos 個字元，而不是從開頭算起。在任何形式的這個函數中，都可以為 pos 使用負值。pos 的值為 0 會傳回空字串。

對於所有形式的 SUBSTRING()，要擷取子字串的字串中，第一個字元的位置計算為 1。

mysql> SELECT SUBSTRING('Quadratically',5);
        -> 'ratically'
mysql> SELECT SUBSTRING('foobarbar' FROM 4);
        -> 'barbar'
mysql> SELECT SUBSTRING('Quadratically',5,6);
        -> 'ratica'
mysql> SELECT SUBSTRING('Sakila', -3);
        -> 'ila'
mysql> SELECT SUBSTRING('Sakila', -5, 3);
        -> 'aki'
mysql> SELECT SUBSTRING('Sakila' FROM -4 FOR 2);
        -> 'ki'

此函數是多位元組安全。如果任何引數為 NULL，則傳回 NULL。

如果 len 小於 1，結果會是空字串。

SUBSTRING_INDEX(str,delim,count)

傳回字串 str 中，在 delim 定界符出現 count 次之前的部分子字串。如果 count 為正數，則傳回最後一個定界符（從左邊算起）左邊的所有內容。如果 count 為負數，則傳回最後一個定界符（從右邊算起）右邊的所有內容。搜尋 delim 時，SUBSTRING_INDEX() 會執行區分大小寫的匹配。

mysql> SELECT SUBSTRING_INDEX('www.mysql.com', '.', 2);
        -> 'www.mysql'
mysql> SELECT SUBSTRING_INDEX('www.mysql.com', '.', -2);
        -> 'mysql.com'

此函數是多位元組安全的。

如果任何引數為 NULL，SUBSTRING_INDEX() 會傳回 NULL。

TO_BASE64(str)

將字串引數轉換為 base-64 編碼形式，並將結果以連線字元集和定序作為字元字串傳回。如果引數不是字串，則會在轉換發生之前將其轉換為字串。如果引數為 NULL，則結果為 NULL。可以使用 FROM_BASE64() 函數解碼 Base-64 編碼的字串。

mysql> SELECT TO_BASE64('abc'), FROM_BASE64(TO_BASE64('abc'));
        -> 'JWJj', 'abc'

存在不同的 base-64 編碼配置。TO_BASE64() 和 FROM_BASE64() 使用的編碼和解碼規則如下

TRIM([{BOTH | LEADING | TRAILING} [remstr] FROM] str)、TRIM([remstr FROM] str)

傳回移除所有 remstr 前置詞或後綴的字串 str。如果未指定 BOTH、LEADING 或 TRAILING 任何一個指定詞，則會假設為 BOTH。remstr 是可選的，如果未指定，則會移除空格。

mysql> SELECT TRIM('  bar   ');
        -> 'bar'
mysql> SELECT TRIM(LEADING 'x' FROM 'xxxbarxxx');
        -> 'barxxx'
mysql> SELECT TRIM(BOTH 'x' FROM 'xxxbarxxx');
        -> 'bar'
mysql> SELECT TRIM(TRAILING 'xyz' FROM 'barxxyz');
        -> 'barx'

此函數是多位元組安全。如果任何引數為 NULL，則傳回 NULL。

UCASE(str)

UCASE() 是 UPPER() 的同義詞。

在檢視中使用的 UCASE() 會改寫為 UPPER()。

UNHEX(str)

對於字串引數 str，UNHEX(str) 會將引數中的每對字元視為十六進位數字，並將其轉換為該數字所代表的位元組。傳回值為二進位字串。

mysql> SELECT UNHEX('4D7953514C');
        -> 'MySQL'
mysql> SELECT X'4D7953514C';
        -> 'MySQL'
mysql> SELECT UNHEX(HEX('string'));
        -> 'string'
mysql> SELECT HEX(UNHEX('1267'));
        -> '1267'

引數字串中的字元必須是合法的十六進位數字：'0' .. '9'、'A' .. 'F'、'a' .. 'f'。如果引數包含任何非十六進位數字，或本身為 NULL，則結果為 NULL。

mysql> SELECT UNHEX('GG');
+-------------+
| UNHEX('GG') |
+-------------+
| NULL        |
+-------------+

mysql> SELECT UNHEX(NULL);
+-------------+
| UNHEX(NULL) |
+-------------+
| NULL        |
+-------------+

如果 UNHEX() 的引數是 BINARY 資料行，也可能發生 NULL 結果，因為值在儲存時會以 0x00 位元組填補，但在擷取時不會移除這些位元組。例如，'41' 會以 '41 ' 儲存到 CHAR(3) 資料行中，並以 '41' 擷取（移除尾隨的填補空格），因此該資料行值的 UNHEX() 會傳回 X'41'。相反地，'41' 會以 '41\0' 儲存到 BINARY(3) 資料行中，並以 '41\0' 擷取（未移除尾隨的填補 0x00 位元組）。'\0' 不是合法的十六進位數字，因此該資料行值的 UNHEX() 會傳回 NULL。

對於數值引數 N，UNHEX() 不會執行 HEX(N) 的反向操作。請改用 CONV(HEX(N),16,10)。請參閱 HEX() 的說明。

如果從 mysql 用戶端內呼叫 UNHEX()，則二進位字串會使用十六進位標記法顯示，具體取決於 --binary-as-hex 的值。如需該選項的詳細資訊，請參閱第 6.5.1 節「mysql — MySQL 命令列用戶端」。

UPPER(str)

根據目前的字元集對應，傳回將所有字元變更為大寫的字串 str，如果 str 為 NULL，則傳回 NULL。預設字元集為 utf8mb4。

mysql> SELECT UPPER('Hej');
        -> 'HEJ'

請參閱 LOWER() 的說明，其中也適用於 UPPER()。這包括如何針對這些函式無效的二進位字串（BINARY、VARBINARY、BLOB）執行字母大小寫轉換，以及有關 Unicode 字元集的大小寫摺疊的資訊。

此函數是多位元組安全的。

在檢視中使用的 UCASE() 會改寫為 UPPER()。

WEIGHT_STRING(str [AS {CHAR|BINARY}(N)] [flags])

此函式會傳回輸入字串的權重字串。傳回值是一個二進位字串，表示字串的比較和排序值，如果引數為 NULL，則傳回 NULL。它具有以下屬性：

WEIGHT_STRING() 是一個除錯函式，旨在供內部使用。其行為可能會在 MySQL 版本之間變更，恕不另行通知。它可用於測試和除錯定序，特別是當您要新增新的定序時。請參閱第 12.14 節「將定序新增至字元集」。

此清單簡要總結了引數。在清單後面的討論中會提供更多詳細資訊。

輸入字串 str 是一個字串運算式。如果輸入是非二進位（字元）字串，例如 CHAR、VARCHAR 或 TEXT 值，則傳回值會包含字串的定序權重。如果輸入是二進位（位元組）字串，例如 BINARY、VARBINARY 或 BLOB 值，則傳回值與輸入相同（二進位字串中每個位元組的權重都是位元組值）。如果輸入為 NULL，則 WEIGHT_STRING() 會傳回 NULL。

範例

mysql> SET @s = _utf8mb4 'AB' COLLATE utf8mb4_0900_ai_ci;
mysql> SELECT @s, HEX(@s), HEX(WEIGHT_STRING(@s));
+------+---------+------------------------+
| @s   | HEX(@s) | HEX(WEIGHT_STRING(@s)) |
+------+---------+------------------------+
| AB   | 4142    | 1C471C60               |
+------+---------+------------------------+

mysql> SET @s = _utf8mb4 'ab' COLLATE utf8mb4_0900_ai_ci;
mysql> SELECT @s, HEX(@s), HEX(WEIGHT_STRING(@s));
+------+---------+------------------------+
| @s   | HEX(@s) | HEX(WEIGHT_STRING(@s)) |
+------+---------+------------------------+
| ab   | 6162    | 1C471C60               |
+------+---------+------------------------+

mysql> SET @s = CAST('AB' AS BINARY);
mysql> SELECT @s, HEX(@s), HEX(WEIGHT_STRING(@s));
+------+---------+------------------------+
| @s   | HEX(@s) | HEX(WEIGHT_STRING(@s)) |
+------+---------+------------------------+
| AB   | 4142    | 4142                   |
+------+---------+------------------------+

mysql> SET @s = CAST('ab' AS BINARY);
mysql> SELECT @s, HEX(@s), HEX(WEIGHT_STRING(@s));
+------+---------+------------------------+
| @s   | HEX(@s) | HEX(WEIGHT_STRING(@s)) |
+------+---------+------------------------+
| ab   | 6162    | 6162                   |
+------+---------+------------------------+

先前的範例使用 HEX() 來顯示 WEIGHT_STRING() 結果。由於結果是二進位值，因此當結果包含非列印值時，HEX() 特別有用，可用於以可列印的形式顯示它。

mysql> SET @s = CONVERT(X'C39F' USING utf8mb4) COLLATE utf8mb4_czech_ci;
mysql> SELECT HEX(WEIGHT_STRING(@s));
+------------------------+
| HEX(WEIGHT_STRING(@s)) |
+------------------------+
| 0FEA0FEA               |
+------------------------+

對於非 NULL 的傳回值，如果值的長度在 VARBINARY 的最大長度內，則值的資料類型為 VARBINARY，否則資料類型為 BLOB。

可以指定 AS 子句，將輸入字串轉換為非二進位或二進位字串，並強制其為指定的長度。

mysql> SET NAMES 'latin1';
mysql> SELECT HEX(WEIGHT_STRING('ab' AS CHAR(4)));
+-------------------------------------+
| HEX(WEIGHT_STRING('ab' AS CHAR(4))) |
+-------------------------------------+
| 41422020                            |
+-------------------------------------+
mysql> SET NAMES 'utf8mb4';
mysql> SELECT HEX(WEIGHT_STRING('ab' AS CHAR(4)));
+-------------------------------------+
| HEX(WEIGHT_STRING('ab' AS CHAR(4))) |
+-------------------------------------+
| 1C471C60                            |
+-------------------------------------+

mysql> SELECT HEX(WEIGHT_STRING('ab' AS BINARY(4)));
+---------------------------------------+
| HEX(WEIGHT_STRING('ab' AS BINARY(4))) |
+---------------------------------------+
| 61620000                              |
+---------------------------------------+

flags 子句目前未使用。

如果從 mysql 用戶端內呼叫 WEIGHT_STRING()，則二進位字串會使用十六進位標記法顯示，具體取決於 --binary-as-hex 的值。如需該選項的詳細資訊，請參閱第 6.5.1 節「mysql — MySQL 命令列用戶端」。