array_shift_left()array_shift_left()

dynamic 数组中的值向左移动。Shifts the values inside a dynamic array to the left.

语法Syntax

array_shift_left(arr , shift_count [, fill_value ])array_shift_left(arr , shift_count [, fill_value ])

参数Arguments

  • arr :要拆分的输入数组,必须是动态数组。arr : Input array to split, must be dynamic array.
  • shift_count :整数,用于指定数组元素将向左移动的位置数。shift_count : Integer specifying the number of positions that array elements will be shifted to the left. 如果该值为负数,则元素将向右移动。If the value is negative, the elements will be shifted to the right.
  • fill_value :用于插入元素的标量值,而不是移动和删除的元素。fill_value : Scalar value that is used for inserting elements instead of the ones that were shifted and removed. 默认值:null 值或空字符串(取决于 arr 类型)。Default: null value or empty string (depending on the arr type).

返回Returns

包含的元素数与原始数组中的元素数相同的动态数组。Dynamic array containing the same number of elements as in the original array. 每个元素均已根据 shift_count 进行了移动。Each element has been shifted according to shift_count. 为代替已删除元素而添加的新元素的值为 fill_value。New elements that are added in place of removed elements will have a value of fill_value.

请参阅See also

示例Examples

  • 向左移动两个位置:Shifting to the left by two positions:

    print arr=dynamic([1,2,3,4,5]) 
    | extend arr_shift=array_shift_left(arr, 2)
    
    arr arr_shift
    [1,2,3,4,5][1,2,3,4,5] [3,4,5,null,null][3,4,5,null,null]
  • 向左移动两个位置并添加默认值:Shifting to the left by two positions and adding default value:

    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,2,3,4,5] [3,4,5,-1,-1][3,4,5,-1,-1]
  • 使用负 shift_count 值向右移动两个位置:Shifting to the right by two positions by using negative shift_count value:

    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,2,3,4,5] [-1,-1,1,2,3][-1,-1,1,2,3]