array_shift_right()

Si applica a: ✅Microsoft Fabric

Sposta i valori all'interno di una matrice dinamica a destra.

Sintassi

array_shift_right( matrice, shift_count [,default_value ])

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Digita	Obbligatorio	Descrizione
array	dynamic	✔️	Matrice da spostare.
shift_count	int	✔️	Numero di posizioni che gli elementi della matrice vengono spostati a destra. Se il valore è negativo, gli elementi vengono spostati a sinistra.
default_value	scalare		Valore utilizzato per un elemento spostato e rimosso. Il valore predefinito è Null o una stringa vuota a seconda del tipo di elementi nella matrice.

Valori restituiti

Restituisce una matrice dinamica contenente la stessa quantità di elementi della matrice originale. Ogni elemento è stato spostato in base a shift_count. I nuovi elementi aggiunti anziché gli elementi rimossi hanno un valore di default_value.

Esempi

Nell'esempio seguente viene illustrato lo spostamento a destra di due posizioni:

Eseguire la query

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

Risultato

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

Nell'esempio seguente viene illustrato lo spostamento a destra di due posizioni e l'aggiunta di un valore predefinito:

Eseguire la query

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

Risultato

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

Nell'esempio seguente viene illustrato lo spostamento a sinistra di due posizioni usando un valore di shift_count negativo:

Eseguire la query

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

Risultato

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

Contenuto correlato

• Per spostare una matrice a sinistra, usare array_shift_left().To shift an array to the left, use array_shift_left().
• Per ruotare una matrice a destra, usare array_rotate_right().
• Per ruotare una matrice a sinistra, usare array_rotate_left().