数组函数和操作符

数组函数和操作符¶

数组操作符¶

如下，数组操作符显示了可以用于数组类型的操作符。

`=`¶

操作符: =
描述: 等于
示例: ``` sql seaboxsql=# SELECT ARRAY[1.1,2.1,3.1]::int[] = ARRAY[1,2,3]; ?column?
t (1 row) ```

`<>`¶

操作符: <>
描述: 不等于
示例: ``` sql seaboxsql=# SELECT ARRAY[1,2,3] <> ARRAY[1,2,4]; ?column?
t (1 row) ```

`<`¶

操作符: <
描述: 小于
示例: ``` sql seaboxsql=# SELECT ARRAY[1,2,3] < ARRAY[1,2,4]; ?column?
t (1 row) ```

`>`¶

操作符: >
描述: 大于
示例: ``` sql seaboxsql=# SELECT ARRAY[1,4,3] > ARRAY[1,2,4]; ?column?
t (1 row) ```

`<=`¶

操作符: <=
描述: 小于等于
示例: ``` sql seaboxsql=# SELECT ARRAY[1,2,3] <= ARRAY[1,2,3]; ?column?
t (1 row) ```

`>=`¶

操作符: >=
描述: 大于等于
示例: ``` sql seaboxsql=# SELECT ARRAY[1,4,3] >= ARRAY[1,4,3]; ?column?
t (1 row) ```

`@>`¶

操作符: @>
描述: 包含
示例: ``` sql seaboxsql=# SELECT ARRAY[1,4,3] @> ARRAY[3,1]; ?column?
t (1 row) ```

`<@`¶

操作符: <@
描述: 被包含
示例: ``` sql seaboxsql=# SELECT ARRAY[2,7] <@ ARRAY[1,7,4,2,6]; ?column?
t (1 row) ```

`&&`¶

操作符: &&
描述: 重叠（具有公共元素）
示例: ``` sql seaboxsql=# SELECT ARRAY[1,4,3] && ARRAY[2,1]; ?column?
t (1 row) ```

`||`¶

操作符

||

描述

数组和数组串接或元素到数组串接

示例

``` sql seaboxsql=# SELECT ARRAY[1,2,3] || ARRAY[4,5,6]; ?column?

{1,2,3,4,5,6} (1 row)

seaboxsql=# SELECT ARRAY[1,2,3] || ARRAY[[4,5,6],[7,8,9]]; ?column?

{{1,2,3},{4,5,6},{7,8,9}} (1 row)

seaboxsql=# SELECT 3||ARRAY[4,5,6]; ?column?

{3,4,5,6} (1 row)

seaboxsql=# SELECT ARRAY[4,5,6] ||7; ?column?

{4,5,6,7} ```

数组比较默认使用 B-Tree方式，通过元素数据类型的比较函数对数组元素逐一进行。

多维数组的元素按照行序进行访问（最后的下标变化最快）。如果两个数组的内容相同但维数不等，那么维度信息中的第一个不同将决定排序顺序。

数组函数¶

以下是用于数组类型的函数。

`array_append()`¶

语法: array_append(anyarray, anyelement)
返回类型: anyarray
描述: 向一个数组的末端追加一个元素
示例: ``` sql seaboxsql=# SELECT array_append(ARRAY[1,2], 3); array_append
{1,2,3} (1 row) ```

`array_cat()`¶

语法: array_cat(anyarray, anyarray)
返回类型: anyarray
描述: 连接两个数组
示例: ``` sql seaboxsql=# SELECT array_cat(ARRAY[1,2,3], ARRAY[4,5]); array_cat
{1,2,3,4,5} (1 row) ```

`array_ndims()`¶

语法

array_ndims(anyarray)

返回类型

int

描述

返回数组的维度数

示例

``` sql seaboxsql=# SELECT array_ndims(ARRAY[[1,2,3], [4,5,6]]); array_ndims

(1 row) ```

`array_dims()`¶

语法: array_dims(anyarray)
返回类型: text
描述: 返回数组的维度的文本表示
示例: ``` sql seaboxsql=# SELECT array_dims(ARRAY[[1,2,3], [4,5,6]]); array_dims
[1:2][1:3] (1 row) ```

`array_fill()`¶

语法: array_fill(anyelement, int[], [, int[]])
返回类型: anyarray
描述: 返回一个用提供的值和维度初始化好的数组，可以选择下界不为 1
示例: ``` sql seaboxsql=# SELECT array_fill(7, ARRAY[3], ARRAY[2]); array_fill
[2:4]={7,7,7} (1 row) ```

`array_length()`¶

语法

array_length(anyarray, int)

返回类型

int

描述

返回被请求的数组维度的长度

示例

``` sql seaboxsql=# SELECT array_length(array[1,2,3], 1); array_length

(1 row) ```

`array_lower()`¶

语法

array_lower(anyarray, int)

返回类型

int

描述

返回被请求的数组维度的下界

示例

``` sql seaboxsql=# SELECT array_lower('[0:2]={1,2,3}'::int[], 1); array_lower

(1 row) ```

`array_position()`¶

语法

array_position(anyarray, anyelement [, int])

返回类型

int

描述

返回在该数组中从第三个参数指定的元素开始或者第一个元素开始（数组必须是一维的）、第二个参数的第一次出现的下标. 如果值没有找到则返回 NULL。

示例

``` sql seaboxsql=# SELECT array_position(ARRAY['sun','mon','tue','wed','thu','fri','sat'], 'mon'); array_position

(1 row) ```

`array_positions()`¶

语法: array_positions(anyarray, anyelement)
返回类型: int[]
描述: 返回在第一个参数给定的数组（数组必须是一维的）中，第二个参数所有出现位置的下标组成的数组
示例: ``` sql seaboxsql=# SELECT array_positions(ARRAY['A','A','B','A'], 'A'); array_positions
{1,2,4} (1 row) ```

在array_position和array_positions中，每一个数组元素都使用IS NOT DISTINCT FROM语义与要搜索的值比较。

在array_positions中，只有当数组为 NULL时才返回NULL，如果该值没有在该数组中找到则返回一个空数组。

`array_prepend()`¶

语法: array_prepend(anyelement, anyarray)
返回类型: anyarray
描述: 向一个数组的首部追加一个元素
示例: ``` sql seaboxsql=# SELECT array_prepend(1, ARRAY[2,3]); array_prepend
{1,2,3} (1 row) ```

`array_remove()`¶

语法: array_remove(anyarray, anyelement)
返回类型: anyarray
描述: 从数组中移除所有等于给定值的所有元素（数组必须是一维的）
示例: ``` sql seaboxsql=# SELECT array_remove(ARRAY[1,2,3,2], 2); array_remove
{1,3} (1 row) ```

`array_replace()`¶

语法: array_replace(anyarray, anyelement, anyelement)
返回类型: anyarray
描述: 将每一个等于给定值的数组元素替换成一个新值
示例: ``` sql seaboxsql=# SELECT array_replace(ARRAY[1,2,5,4], 5, 3); array_replace
{1,2,3,4} (1 row) ```

`array_to_string()`¶

语法: array_to_string(anyarray, text [, text])
返回类型: text
描述: 使用提供的定界符和可选的空串连接数组元素
示例: ``` sql seaboxsql=# SELECT array_to_string(ARRAY[1, 2, 3, NULL, 5], ',', '*'); array_to_string
1,2,3,*,5 (1 row) ```

`array_upper()`¶

语法

array_upper(anyarray, int)

返回类型

int

描述

返回被请求的数组维度的上界

示例

``` sql seaboxsql=# SELECT array_upper(ARRAY[1,8,3,7], 1); array_upper

(1 row) ```

`cardinality()`¶

语法

cardinality(anyarray)

返回类型

int

描述

返回数组中元素的总数，如果数组为空则返回 0

示例

``` sql seaboxsql=# SELECT cardinality(ARRAY[[1,2],[3,4]]); cardinality

(1 row) ```

`string_to_array()`¶

语法: string_to_array(text, text [, text])
返回类型: text[]
描述: 使用提供的定界符和可选的空串将字符串划分成数组元素
示例: ``` sql seaboxsql=# SELECT string_to_array('xx_^yy_^zz', '_^', 'yy'); string_to_array
{xx,NULL,zz} (1 row) ```

在string_to_array中，如果定界符参数为NULL，输入字符串中的每一个字符将变成结果数组中的一个独立元素。如果定界符是一个空串，则整个输入字符串被作为一个单一元素的数组返回。否则输入字符串会被在每一个出现定界符字符串的位置分裂。

在string_to_array中，如果空值串参数被忽略或者为 NULL，输入中的子串不会被替换成NULL。在array_to_string中，如果空值串参数被忽略或者为NULL，该数组中的任何空值元素会被简单地跳过并且不会在输出串中被表示。

`unnest()`¶

语法

unnest(anyarray[, ...])

返回类型

setof anyelement

描述

将一个数组扩展成一组行，参数为多个数组时把多维数组（可能是不同类型）扩展成一个行的集合。

示例

``` sql seaboxsql=# SELECT unnest(ARRAY[1,2]); unnest

1 2 (2 row)

seaboxsql=# SELECT unnest(ARRAY[1,2],ARRAY['foo','bar','baz']); ?column?

1 foo
2 bar
NULL baz1
(2 row) ```

数组函数和操作符