FUNCTION数组函数和操作符
array_fill
返回一个包含给定值的拷贝的数组，其维数与第二个参数指定的长度相同。
Returns an array filled with copies of the given value, having dimensions of the lengths specified by the second argument.
数组函数和操作符 引入 9.0（基线） 现存至 20 devel 1 条签名 1 次签名变更
- 分组
- 数组函数和操作符
- 签名数
- 1 条
- 引入版本
- 9.0（基线）
- 状态
- 现存
- 签名变更
- 1 次
- 本版来源
- 本站译文
版本轨迹
相对 PostgreSQL 17 无变化。
签名
PostgreSQL 18 里 array_fill 的 1 条签名，按上游手册顺序排列。参数名用斜体，类型用弱化色， 之后是返回类型。说明取自本站手册译文：标「沿用」的借用了另一版的译文，标「EN」的本站暂无译文、按英文原文显示。
-
array_fill(anyelement,integer[][,integer[]] ) →anyarray返回一个包含给定值的拷贝的数组，其维数与第二个参数指定的长度相同。 可选的第三个参数提供每个维度的下界值(默认为全部为1)。array_fill(11, ARRAY[2,3]){{11,11,11},{11,11,11}}array_fill(7, ARRAY[3], ARRAY[2])[2:4]={7,7,7}
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的签名。
-
PostgreSQL 13 ← 12 手册重排
这一跳手册重排了函数表的写法，签名文本整体改写，只记函数的增删，不逐条比较签名。
-
PostgreSQL 9.3 ← 9.2 签名变更
array_fill ( anyelement, int[] [, int[]] ) → anyarrayarray_fill ( anyelement, int[], [, int[]] ) → anyarray
签名矩阵
每条签名在给出了签名的 18 个版本里的存在情况；方格指向该版的签名。只在正文里提到此函数、没有给出签名的版本不列进来，上面的版本轨迹里仍然有它们。签名文本在 PostgreSQL 13 前后写法不同，跨越那一跳的同一条签名会显示成两行。
存在 不存在
| 签名 | 9.0 | 9.1 | 9.2 | 9.3 | 9.4 | 9.5 | 9.6 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
array_fill ( anyelement, int[], [, int[]] ) → anyarray |
存在 | 存在 | 存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 |
array_fill ( anyelement, int[] [, int[]] ) → anyarray |
不存在 | 不存在 | 不存在 | 存在 | 存在 | 存在 | 存在 | 存在 | 存在 | 存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 |
array_fill ( anyelement, integer[] [, integer[] ] ) → anyarray |
不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 存在 | 存在 | 存在 | 存在 | 存在 | 存在 | 存在 | 存在 |
同组函数
| 函数 | 签名 | 主签名 | 版本变动 | 最近变更 |
|---|---|---|---|---|
array_append基线 |
1 | array_append ( anycompatiblearray, anycompatible ) → anycompatiblearray |
141 次 | |
| 向一个数组的末端追加一个元素 (等同于 anycompatiblearray || anycompatible 操作符)。 | 现存 | |||
array_cat基线 |
1 | array_cat ( anycompatiblearray, anycompatiblearray ) → anycompatiblearray |
141 次 | |
| 连接两个数组(等同于 anycompatiblearray || anycompatiblearray 操作符)。 | 现存 | |||
array_dims基线 |
1 | array_dims ( anyarray ) → text |
— | |
| 返回数组维度的文本表示形式。 | 现存 | |||
array_fill基线 |
1 | array_fill ( anyelement, integer[] [, integer[] ] ) → anyarray |
9.31 次 | |
| 返回一个包含给定值的拷贝的数组，其维数与第二个参数指定的长度相同。 | 现存 | |||
array_length基线 |
1 | array_length ( anyarray, integer ) → integer |
— | |
| 返回请求的数组维度的长度。 | 现存 | |||
array_lower基线 |
1 | array_lower ( anyarray, integer ) → integer |
— | |
| 返回请求的数组维度的下界。 | 现存 | |||
array_ndims基线 |
1 | array_ndims ( anyarray ) → integer |
— | |
| 返回数组的维度数。 | 现存 | |||
array_position |
1 | array_position ( anycompatiblearray, anycompatible [, integer ] ) → integer |
141 次 | |
| 返回阵列中第二个参数中第一次发生的下标，如果它不存在，则返回NULL。 | 现存 | |||
array_positions |
1 | array_positions ( anycompatiblearray, anycompatible ) → integer[] |
141 次 | |
| 返回作为第一个参数的数组中第二个参数所有出现的下标的数组。 | 现存 | |||
array_prepend基线 |
1 | array_prepend ( anycompatible, anycompatiblearray ) → anycompatiblearray |
141 次 | |
| 在数组的开头添加一个元素(等同于anycompatible || anycompatiblearray操作符)。 | 现存 | |||
array_remove |
1 | array_remove ( anycompatiblearray, anycompatible ) → anycompatiblearray |
141 次 | |
| 从数组中移除与给定值相等的所有元素。 | 现存 | |||
array_replace |
1 | array_replace ( anycompatiblearray, anycompatible, anycompatible ) → anycompatiblearray |
141 次 | |
| 将等于第二个参数的每个数组元素替换为第三个参数。 | 现存 | |||
array_reverse |
1 | array_reverse ( anyarray ) → anyarray |
— | |
| 反转数组的第一维。 | 现存 | |||
array_sample |
1 | array_sample ( array anyarray, n integer ) → anyarray |
— | |
| 从array中随机选取n个项并返回一个数组。 | 现存 | |||
array_shuffle |
1 | array_shuffle ( anyarray ) → anyarray |
— | |
| 随机打乱数组的第一维。 | 现存 | |||
array_sort |
1 | array_sort ( array anyarray [, descending boolean [, nulls_first boolean ]] ) → anyarray |
— | |
| 对数组的第一维进行排序。 | 现存 | |||
array_to_string基线 |
1 | array_to_string ( array anyarray, delimiter text [, null_string text ] ) → text |
9.11 次 | |
| 将每个数组元素转换为其文本表示，并将它们用delimiter字符串分隔连接起来。 | 现存 | |||
array_upper基线 |
1 | array_upper ( anyarray, integer ) → integer |
— | |
| 返回请求的数组维度的上界。 | 现存 | |||
cardinality |
1 | cardinality ( anyarray ) → integer |
— | |
| 返回数组中元素的总数，如果数组为空则返回0。 | 现存 | |||
trim_array |
1 | trim_array ( array anyarray, n integer ) → anyarray |
— | |
| 通过删除最后的n元素来裁剪数组。 | 现存 | |||