Skip to content

PostgreSQL array_append() 函数 ​

PostgreSQL array_append() 函数将指定的元素追加到指定的数组的最后并返回修改后的数组。

array_append() 语法 ​

这里是 PostgreSQL array_append() 函数的语法:

sql
array_append(array, element) -> array

参数 ​

  • array

    必需的。 要追加元素的数组。

  • element

    必需的。 要追加到数组的元素。

返回值 ​

PostgreSQL array_append() 函数返回一个在其最后追加了指定元素的数组。

如果参数 array 为 NULL,array_append() 函数将返回一个只包含元素 element 的数组。

添加的元素的类型需要和数组中类型相同,否则 array_append() 函数将会给出一个错误提示。

array_append() 示例 ​

本示例展示了如何使用 PostgreSQL array_append() 函数在数组 {0,1,2} 的最后追加一个元素 3。

sql
SELECT array_append(ARRAY[0, 1, 2], 3);
bash
 array_append
--------------
 {0,1,2,3}

您可以将参数 array 指定为 NULL。例如:

sql
SELECT array_append(NULL, 1);
bash
 array_append
--------------
 {1}

您不能向一个数组中添加不同数据类型的元素。比如,您不能像一个整形的数组中添加一个字符串类型的元素,就像下面一样:

sql
SELECT array_append(ARRAY[0, 1, 2], 'three');

array_append() 函数会返回一个错误:

bash
错误:  无效的类型 integer 输入语法: "three"
第1行SELECT array_append(ARRAY[0, 1, 2], 'three');
                                         ^