array_shift_right()
Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Desplaza los valores dentro de una matriz dinámica a la derecha.
Sintaxis
array_shift_right(array, shift_count [, default_value ])
Obtenga más información sobre las convenciones de sintaxis.
Parámetros
| Nombre | Type | Obligatorio | Descripción |
|---|---|---|---|
| array | dynamic |
✔️ | Matriz que se va a desplazar. |
| shift_count | int |
✔️ | Número de posiciones que los elementos de matriz se desplazan a la derecha. Si el valor es negativo, los elementos se desplazan a la izquierda. |
| default_value | escalares | Valor utilizado para un elemento que se ha desplazado y quitado. El valor predeterminado es null o una cadena vacía en función del tipo de elementos de la matriz. |
Devoluciones
Devuelve una matriz dinámica que contiene la misma cantidad de elementos que en la matriz original. Cada elemento se ha desplazado según shift_count. Los nuevos elementos que se agregan en lugar de los elementos quitados tienen un valor de default_value.
Ejemplos
Desplazarse a la derecha por dos posiciones:
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_right(arr, 2)
Salida
| arr | arr_shift |
|---|---|
| [1,2,3,4,5] | [null,null,1,2,3] |
Cambiar a la derecha por dos posiciones y agregar un valor predeterminado:
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_right(arr, 2, -1)
Salida
| arr | arr_shift |
|---|---|
| [1,2,3,4,5] | [-1,-1,1,2,3] |
Al desplazarse a la izquierda por dos posiciones, use un valor de shift_count negativo:
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_right(arr, -2, -1)
Salida
| arr | arr_shift |
|---|---|
| [1,2,3,4,5] | [3,4,5,-1,-1] |
Contenido relacionado
- Para desplazar una matriz a la izquierda, use array_shift_left().
- Para girar una matriz a la derecha, use array_rotate_right().
- Para girar una matriz a la izquierda, use array_rotate_left().