array_shift_right()
将动态数组中的值向右移动。
语法
array_shift_right(
array, shift_count [,
default_value ])
详细了解语法约定。
参数
客户 | 类型 | 必需 | 说明 |
---|---|---|---|
array | dynamic |
✔️ | 要移动的数组。 |
shift_count | int |
✔️ | 数组元素向右移动的位置数。 如果值为负数,则元素向左移动。 |
default_value | 标量 (scalar) | 用于已移动和已移除的元素的值。 默认值为 null 或空字符串,具体取决于 array 中元素的类型。 |
返回
返回一个包含与原始数组相同元素数的动态数组。 每个元素均已根据 shift_count 进行了移动。 添加的新元素(而不是移除的元素)将包含值 default_value。
示例
向右移动两个位置:
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_right(arr, 2)
输出
arr | arr_shift |
---|---|
[1,2,3,4,5] | [null,null,1,2,3] |
向右移动两个位置并添加默认值:
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_right(arr, 2, -1)
输出
arr | arr_shift |
---|---|
[1,2,3,4,5] | [-1,-1,1,2,3] |
使用负 shift_count 值向左移动两个位置:
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_right(arr, -2, -1)
输出
arr | arr_shift |
---|---|
[1,2,3,4,5] | [3,4,5,-1,-1] |
相关内容
- 若要将数组向左移动,请使用 array_shift_left()。
- 若要向右旋转数组,请使用 array_rotate_right()。
- 若要向左旋转数组,请使用 array_rotate_left()。