9.18. 数组函数和运算符

只因后端
129 阅读4分钟

9.18. 数组函数和运算符

表 9.48 显示了可用于数组类型的运算符。

表 9.48.阵列运算符

算子描述例结果
=平等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,3]t
<@包含在ARRAY[2,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}}
``元素到数组串联`3ARRAY[4,5,6]`{3,4,5,6}
``数组到元素串联`ARRAY[4,5,6]7`{4,5,6,7}

数组排序运算符 （， 等） 使用元素数据类型的默认 B 树比较函数逐个元素比较数组内容，并根据第一个差异进行排序。在多维数组中，元素按行主顺序访问（最后一个下标变化最快）。如果两个数组的内容相等但维数不同，则维数信息的第一个差异决定了排序顺序。（这是与 8.2 之前的 PostgreSQL 版本相比的变化：旧版本会声称具有相同内容的两个数组是相等的，即使维度或下标范围不同。<``>=

数组包含运算符 （ 和 ） 认为一个数组包含在另一个数组中，如果它的每个元素都出现在另一个数组中。因此，重复项不被特殊处理，并且每个都被视为包含另一个。<@``@>``ARRAY[1]``ARRAY[1,1]

有关阵列运算符行为的更多详细信息，请参见第 8.15 节。有关哪些运算符支持索引操作的更多详细信息，请参阅第 11.2 节。

表 9.49 显示了可用于数组类型的函数。有关使用这些函数的更多信息和示例，请参见第 8.15 节。

表 9.49.数组函数

功能返回类型描述例结果
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_position(anyarray, anyelement [, int])int返回数组中第二个参数第一次出现的下标，从第三个参数指示的元素或第一个元素开始（数组必须是一维的）array_position(ARRAY['sun','mon','tue','wed','thu','fri','sat'], 'mon')2
array_positions(anyarray, anyelement)int[]返回作为第一个参数的数组中第二个参数的所有匹配项的下标数组（数组必须是一维的）array_positions(ARRAY['A','A','B','A'], 'A'){1,2,4}
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
cardinality(anyarray)int返回数组中的元素总数，如果数组为空，则返回 0cardinality(ARRAY[[1,2],[3,4]])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
| `unnest(anyarray, anyarray [, ...])`              | `setof anyelement, anyelement [, ...]` | 将多个数组（可能具有不同类型的数组）扩展到一组行。这仅在 FROM 子句中允许;参见[第 7.2.1.4 节](https://www.postgresql.org/docs/11/queries-table-expressions.html#QUERIES-TABLEFUNCTIONS "7.2.1.4. Table Functions") | `unnest(ARRAY[1,2],ARRAY['foo','bar','baz'])`                             | ```
1    foo 2    bar NULL baz
```（3 行） |

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

如果找不到该值，则返回 。`array_position``NULL`

在 中，仅当数组为 ;如果在数组中找不到该值，则返回一个空数组。`array_positions``NULL``NULL`

在 中，如果分隔符参数为 NULL，则输入字符串中的每个字符将成为结果数组中的单独元素。如果分隔符为空字符串，则整个输入字符串将作为单元素数组返回。否则，每次出现分隔符字符串时都会拆分输入字符串。`string_to_array`

在 中，如果省略空字符串参数或 NULL，则输入的任何子字符串都不会替换为 NULL。在 中，如果省略 null-string 参数或 null，则数组中的任何 null 元素都将被跳过，而不会在输出字符串中表示。`string_to_array``array_to_string`

### 注意

与 PostgreSQL 的 9.1 之前版本的行为有两个不同之处。首先，当输入字符串长度为零时，它将返回一个空（零元素）数组而不是 NULL。其次，如果分隔符字符串为 NULL，则该函数会将输入拆分为单个字符，而不是像以前那样返回 NULL。`string_to_array`

另请参阅[第 9.20 节](https://www.postgresql.org/docs/11/functions-aggregate.html "9.20. Aggregate Functions")，了解用于数组的聚合函数。`array_agg`
avatar
文章
阅读
粉丝