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()。