9.5. 二進制字符串函數和操作符 · PostgreSQL 中文文檔 9.3

# 9.5\. 二進制字符串函數和操作符本節描述那些檢查和操作類型為`bytea`數值的函數和操作符。 SQL定義了一些字符串函數，在這些函數里使用關鍵字而不是逗號來分隔參數。詳情請見[Table 9-8](#calibre_link-2190)。 PostgreSQL也提供了使用常用語法進行函數調用的函數的版本 (參閱[Table 9-9](#calibre_link-1072))。 > **Note:** 本頁面例子的結果在假設服務器的參數[`bytea_output`](#calibre_link-1042) 設置為`escape`的基礎上的（傳統的PostgreSQL格式）。 **Table 9-8\. SQL 二進制字符串函數和操作符** | 函數 | 返回類型 | 描述 | 例子 | 結果 | | --- | --- | --- | --- | --- | | `string` `||` `string` | `bytea` | 字符串連接 | `E'\\\\Post'::bytea || E'\\047gres\\000'::bytea` | `\\Post'gres\000` | | ``octet_length(```string`) | `int` | 二進制字符串中的字節數 | `octet_length(E'jo\\000se'::bytea)` | `5` | | ``overlay(```string` placing `string` from `int` [for `int`]) | `bytea` | 替換子串 | `overlay(E'Th\\000omas'::bytea placing E'\\002\\003'::bytea from 2 for 3)` | `T\\002\\003mas` | | ``position(```substring` in `string`) | `int` | 特定子字符串的位置 | `position(E'\\000om'::bytea in E'Th\\000omas'::bytea)` | `3` | | ``substring(```string` [from `int`] [for `int`]) | `bytea` | 截取子串 | `substring(E'Th\\000omas'::bytea from 2 for 3)` | `h\000o` | | ``trim([both]` ``bytes` from `string`) | `bytea` | 從`string`的開頭和結尾刪除只包含 `bytes`中字節的最長字符串 | `trim(E'\\000'::bytea from E'\\000Tom\\000'::bytea)` | `Tom` | 還有一些二進制字符串處理函數可以使用，在[Table 9-9](#calibre_link-1072) 列出。其中有一些是在內部使用，用于實現[Table 9-8](#calibre_link-2190) 列出的SQL標準的字符串函數。 **Table 9-9\. 其它二進制字符串函數** | 函數 | 返回類型 | 描述 | 例子 | 結果 | | --- | --- | --- | --- | --- | | ``btrim(```string` `bytea`, `bytes` `bytea`) | `bytea` | 從`string`的開頭和結尾刪除只包含`bytes` 中字節的最長的字符串 | `btrim(E'\\000trim\\000'::bytea, E'\\000'::bytea)` | `trim` | | ``decode(```string` `text`, `format` `text`) | `bytea` | 把`string`中的文本表示解碼為二進制數據。`format` 的選項和`encode`相同。 | `decode(E'123\\000456', 'escape')` | `123\000456` | | ``encode(```data` `bytea`, `format` `text`) | `text` | 把二進制數據編碼為文本表現形式。支持的格式：`base64`, `hex`, `escape`。`escape` 轉換零字節和高位設置字節為八進制序列(`\``_nnn_`) 和雙寫反斜杠。 | `encode(E'123\\000456'::bytea, 'escape')` | `123\000456` | | ``get_bit(```string`, `offset`) | `int` | 從字符串中抽取位 | `get_bit(E'Th\\000omas'::bytea, 45)` | `1` | | ``get_byte(```string`, `offset`) | `int` | 從字符串中抽取字節 | `get_byte(E'Th\\000omas'::bytea, 4)` | `109` | | ``length(```string`) | `int` | 二進制字符串的長度 | `length(E'jo\\000se'::bytea)` | `5` | | ``md5(```string`) | `text` | 計算`string`的MD5散列值，以十六進制方式返回結果。 | `md5(E'Th\\000omas'::bytea)` | `8ab2d3c9689aaf18 b4958c334c82d8b1` | | ``set_bit(```string`, `offset`, `newvalue`) | `bytea` | 設置字符串中的位 | `set_bit(E'Th\\000omas'::bytea, 45, 0)` | `Th\000omAs` | | ``set_byte(```string`, `offset`, `newvalue`) | `bytea` | 設置字符串中的字節 | `set_byte(E'Th\\000omas'::bytea, 4, 64)` | `Th\000o@as` | `get_byte`和`set_byte`數以二進制字符串的第一個字節為0字節。 `get_bit`和`set_bit`從每個字節的右邊取位；例如位0是第一個字節的最低位，位15是第二個字節的最高位。又見[Section 9.20](#calibre_link-1641)中的聚集函數`string_agg`。