array_shift_left()
将动态数组中的值向右移动。
语法
array_shift_left(
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_left(arr, 2)
输出
arr | arr_shift |
---|---|
[1,2,3,4,5] | [3,4,5,null,null] |
向左移动两个位置并添加默认值:
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_left(arr, 2, -1)
输出
arr | arr_shift |
---|---|
[1,2,3,4,5] | [3,4,5,-1,-1] |
使用负 shift_count 值向右移动两个位置:
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_left(arr, -2, -1)
输出
arr | arr_shift |
---|---|
[1,2,3,4,5] | [-1,-1,1,2,3] |
相关内容
- 若要将数组向右移动,请使用 array_shift_right()。
- 若要向右旋转数组,请使用 array_rotate_right()。
- 若要向左旋转数组,请使用 array_rotate_left()。