9.18. 數組函數和操作符 · PostgreSQL 中文文檔 9.3

{% raw %} # 9.18\. 數組函數和操作符 [Table 9-42](#calibre_link-2232)顯示了可以用于 array 類型的操作符。 **Table 9-42\. Array 操作符** | 操作符 | 描述 | 例子 | 結果 | | --- | --- | --- | --- | | `=` | 等于 | `ARRAY[1.1,2.1,3.1]::int[] = ARRAY[1,2,3]` | `t` | | `<>` | 不等于 | `ARRAY[1,2,3] <> ARRAY[1,2,4]` | `t` | | `<` | 小于 | `ARRAY[1,2,3] < ARRAY[1,2,4]` | `t` | | `>` | 大于 | `ARRAY[1,4,3] > ARRAY[1,2,4]` | `t` | | `<=` | 小于或等于 | `ARRAY[1,2,3] <= ARRAY[1,2,3]` | `t` | | `>=` | 大于或等于 | `ARRAY[1,4,3] >= ARRAY[1,4,3]` | `t` | | `@>` | 包含 | `ARRAY[1,4,3] @> ARRAY[3,1]` | `t` | | `<@` | 被包含于 | `ARRAY[2,7] <@ ARRAY[1,7,4,2,6]` | `t` | | `&&` | 重疊(有共同元素) | `ARRAY[1,4,3] && ARRAY[2,1]` | `t` | | `||` | 數組與數組連接 | `ARRAY[1,2,3] || ARRAY[4,5,6]` | `{1,2,3,4,5,6}` | | `||` | 數組與數組連接 | `ARRAY[1,2,3] || ARRAY[[4,5,6],[7,8,9]]` | `{{1,2,3},{4,5,6},{7,8,9}}` | | `||` | 元素與數組連接 | `3 || ARRAY[4,5,6]` | `{3,4,5,6}` | | `||` | 數組與元素連接 | `ARRAY[4,5,6] || 7` | `{4,5,6,7}` | 數組比較是使用默認的 B-Tree 比較函數對所有元素逐一進行比較的。多維數組的元素按照行順序進行訪問(最后的下標變化最快)。如果兩個數組的內容相同但維數不等，那么決定排序順序的首要因素將是維數(原文：the first difference in the dimensionality information determines the sort order)，這與PostgreSQL 8.2 之前的版本不同：老版本認為內容相同的兩個數組相等，即使它們的維數或下標范圍并不相同。參閱[Section 8.15](#calibre_link-1759)獲取有關數組操作符行為的更多細節。參閱[Section 11.2](#calibre_link-714)獲取哪個操作符支持索引操作的更多細節。 [Table 9-43](#calibre_link-2233)顯示了可以用于數組類型的函數。參閱[Section 8.15](#calibre_link-1759)獲取更多信息以及使用這些函數的例子。 **Table 9-43\. Array 函數** | 函數 | 返回類型 | 描述 | 例子 | 結果 | | --- | --- | --- | --- | --- | | ``array_append`(``anyarray`, `anyelement`) | `anyarray` | 向數組末尾添加元素 | `array_append(ARRAY[1,2], 3)` | `{1,2,3}` | | ``array_cat`(``anyarray`, `anyarray`) | `anyarray` | 連接兩個數組 | `array_cat(ARRAY[1,2,3], ARRAY[4,5])` | `{1,2,3,4,5}` | | ``array_ndims`(``anyarray`) | `int` | 返回數組的維數 | `array_ndims(ARRAY[[1,2,3], [4,5,6]])` | `2` | | ``array_dims`(``anyarray`) | `text` | 返回數組維數的文本表示 | `array_dims(ARRAY[[1,2,3], [4,5,6]])` | `[1:2][1:3]` | | ``array_fill`(``anyelement`, `int[]`, [, `int[]`]) | `anyarray` | 返回數組初始化提供的值和維度，可選下界不是1 | `array_fill(7, ARRAY[3], ARRAY[2])` | `[2:4]={7,7,7}` | | ``array_length`(``anyarray`, `int`) | `int` | 返回數組維度的長度 | `array_length(array[1,2,3], 1)` | `3` | | ``array_lower`(``anyarray`, `int`) | `int` | 返回數組維數的下界 | `array_lower('[0:2]={1,2,3}'::int[], 1)` | `0` | | ``array_prepend`(``anyelement`, `anyarray`) | `anyarray` | 向數組開頭添加元素 | `array_prepend(1, ARRAY[2,3])` | `{1,2,3}` | | ``array_remove`(``anyarray`, `anyelement`) | `anyarray` | 從數組中刪除所有等于給定值的元素（數組必須是一維的） | `array_remove(ARRAY[1,2,3,2], 2)` | `{1,3}` | | ``array_replace`(``anyarray`, `anyelement`, `anyelement`) | `anyarray` | 用新值替換每個等于給定值的數組元素 | `array_replace(ARRAY[1,2,5,4], 5, 3)` | `{1,2,3,4}` | | ``array_to_string`(``anyarray`, `text` [, `text`]) | `text` | 使用分隔符和null字符串連接數組元素 | `array_to_string(ARRAY[1, 2, 3, NULL, 5], ',', '*')` | `1,2,3,*,5` | | ``array_upper`(``anyarray`, `int`) | `int` | 返回數組維數的上界 | `array_upper(ARRAY[1,8,3,7], 1)` | `4` | | ``string_to_array`(``text`, `text` [, `text`]) | `text[]` | 使用指定的分隔符和null字符串把字符串分裂成數組元素 | `string_to_array('xx~^~yy~^~zz', '~^~', 'yy')` | `{xx,NULL,zz}` | | ``unnest`(``anyarray`) | `setof anyelement` | 擴大一個數組為一組行 | `unnest(ARRAY[1,2])` | `1 2` (2 rows) | 在`string_to_array`中，如果分隔符參數是NULL，輸入字符串中的每個字符將在結果數組中變成一個獨立的元素。如果分隔符是一個空白字符串，那么整個輸入字符串將變為一元素的數組。否則輸入字符串將在每個分隔字符串處分裂。在`string_to_array`中，如果省略null字符串參數或為NULL，將沒有輸入字符串的子串被NULL代替。在`array_to_string`中，如果省略null字符串參數或為NULL，在數組中的任何null元素將簡單的跳過，并且不再輸出字符串中出現。 > **Note:** 在PostgreSQL版本9.1之前，`string_to_array`有兩個行為上的不同。第一，當輸入字符串長度為零時，它將返回一個空（零元素）數組而不是NULL。第二，如果分隔字符串是NULL時，函數分隔輸入為單獨的字符，而不是和以前一樣返回NULL。也可以參閱[Section 9.20](#calibre_link-1641)獲取關于 `array_agg`聚集函數使用數組的信息。 {% raw %}