array_shift_left()

Posune hodnoty uvnitř dynamického pole doleva.

Syntax

array_shift_left(array, shift_count [,default_value ])

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název	Typ	Vyžadováno	Popis
Pole	dynamic	✔️	Pole, které se má posunout.
shift_count	int	✔️	Počet pozic, které jsou prvky pole posunuty doleva. Pokud je hodnota záporná, prvky se posunou doprava.
default_value	Skalár		Hodnota použitá pro prvek, který byl přesunut a odebrán. Výchozí hodnota je null nebo prázdný řetězec v závislosti na typu prvků v poli.

Návraty

Vrátí dynamickou matici obsahující stejný počet prvků jako v původní matici. Každý prvek byl posunut podle shift_count. Nové prvky přidané místo odebraných prvků mají hodnotu default_value.

Příklady

Posun doleva o dvě pozice:

Spuštění dotazu

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

Výstup

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

Posun doleva o dvě pozice a přidání výchozí hodnoty:

Spuštění dotazu

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

Výstup

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

Posun doprava o dvě pozice pomocí záporné shift_count hodnoty:

Spuštění dotazu

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

Výstup

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

Související obsah

• Pokud chcete posunout pole doprava, použijte array_shift_right().
• Pokud chcete otočit pole doprava, použijte array_rotate_right().
• Pokud chcete otočit pole doleva, použijte array_rotate_left().