array_shift_right()

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

Syntax

array_shift_right(array， shift_count [,default_value ])

深入瞭解 語法慣例。

參數

名稱	類型	必要	Description
array	dynamic	✔️	要移位的陣列。
shift_count	int	✔️	陣列元素向右移位的位置數目。 如果值為負數，則元素會向左移。
default_value	純量 (scalar)		用於已移位和移除之元素的值。 默認值為 Null 或空字串，視 陣列中的項目類型而定。

傳回

傳回動態陣列，其中包含與原始數位中相同的元素數量。 每個元素都已根據 shift_count 來移位。 新增的專案，而不是移除的專案具有 值default_value。

範例

向右移位兩個位置：

執行查詢

print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_right(arr, 2)

輸出

arr	arr_shift
[1,2,3,4,5]	[null,null,1,2,3]

向右移位兩個位置，並新增預設值：

執行查詢

print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_right(arr, 2, -1)

輸出

arr	arr_shift
[1,2,3,4,5]	[-1,-1,1,2,3]

使用負數 shift_count 值，向左移位兩個位置：

執行查詢

print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_right(arr, -2, -1)

輸出

arr	arr_shift
[1,2,3,4,5]	[3,4,5,-1,-1]

相關內容

• 若要將陣列向左移，請使用 array_shift_left () 。
• 若要向右旋轉陣列，請使用 array_rotate_right () 。
• 若要向左旋轉陣列，請使用 array_rotate_left () 。