PostgreSQL array_append() 函数使用指南
PostgreSQL array_append()
函数将指定的元素追加到指定的数组的最后并返回修改后的数组。
array_append()
语法
这里是 PostgreSQL array_append()
函数的语法:
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
。
SELECT array_append(ARRAY[0, 1, 2], 3);
array_append
--------------
{0,1,2,3}
您可以将参数 array
指定为 NULL
。例如:
SELECT array_append(NULL, 1);
array_append
--------------
{1}
您不能向一个数组中添加不同数据类型的元素。比如,您不能像一个整形的数组中添加一个字符串类型的元素,就像下面一样:
SELECT array_append(ARRAY[0, 1, 2], 'three');
array_append()
函数会返回一个错误:
错误: 无效的类型 integer 输入语法: "three"
第1行SELECT array_append(ARRAY[0, 1, 2], 'three');
^