array_shift_left()

Przesuwa wartości wewnątrz tablicy dynamicznej po lewej stronie.

Składnia

array_shift_left(tablica, shift_count [,default_value ])

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa Typ Wymagane Opis
Tablicy dynamic ✔️ Tablica do przesunięcia.
shift_count int ✔️ Liczba pozycji, które elementy tablicy są przesuwane po lewej stronie. Jeśli wartość jest ujemna, elementy są przesuwane po prawej stronie.
default_value Wartość skalarna Wartość użyta dla elementu, który został przesunięty i usunięty. Wartość domyślna to null lub pusty ciąg w zależności od typu elementów w tablicy.

Zwraca

Zwraca tablicę dynamiczną zawierającą taką samą liczbę elementów, jak w oryginalnej tablicy. Każdy element został przesunięty zgodnie z shift_count. Nowe elementy dodawane zamiast usuniętych elementów mają wartość default_value.

Przykłady

Przesunięcie w lewo o dwie pozycje:

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

Dane wyjściowe

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

Przesunięcie w lewo o dwie pozycje i dodanie wartości domyślnej:

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

Dane wyjściowe

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

Przesunięcie w prawo o dwie pozycje przy użyciu wartości ujemnej shift_count :

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

Dane wyjściowe

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