array_shift_left() (將陣列左移)

適用於：✅Microsoft網狀架構✅✅

將動態陣列內的值向左移位。

語法

array_shift_left( array， shift_count [,default_value ])

深入瞭解 語法慣例。

參數

姓名	類型​​	必要	描述
陣列	dynamic	✔️	要移位的陣列。
shift_count	int	✔️	陣列專案向左移的位置數目。 如果值為負數，元素會向右移位。
default_value	純量		用於已移位和移除之元素的值。 默認值為 null 或空字串，視陣列中的項目類型而定。

傳回

傳回動態陣列，其中包含與原始數位中相同的項目數目。 每個元素已根據 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（）。