array_shift_left()

适用于:✅Azure 数据资源管理器Azure MonitorMicrosoft Sentinel

动态数组中的值向右移动。

语法

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]