array_shift_right()

Posune hodnoty uvnitř dynamického pole doprava.

Syntax

array_shift_right(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, na které jsou prvky pole posunuty doprava. Pokud je hodnota záporná, prvky se posunou doleva.
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í dynamické pole obsahující stejné množství 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 doprava o dvě pozice:

Spuštění dotazu

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

Výstup

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

Posun doprava 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_right(arr, 2, -1)

Výstup

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

Posunutí doleva 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_right(arr, -2, -1)

Výstup

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

Související obsah

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