array_shift_left()
Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Desplaza los valores dentro de una matriz dinámica a la izquierda.
Sintaxis
array_shift_left(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 izquierda. Si el valor es negativo, los elementos se desplazan a la derecha. |
| 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 el mismo número 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
Desplazamiento a la izquierda por dos posiciones:
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_left(arr, 2)
Salida
| arr | arr_shift |
|---|---|
| [1,2,3,4,5] | [3,4,5,null,null] |
Desplazarse a la izquierda por dos posiciones y agregar el valor predeterminado:
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_left(arr, 2, -1)
Salida
| arr | arr_shift |
|---|---|
| [1,2,3,4,5] | [3,4,5,-1,-1] |
Desplazamiento a la derecha por dos posiciones mediante el uso de un valor de shift_count negativo:
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_left(arr, -2, -1)
Salida
| arr | arr_shift |
|---|---|
| [1,2,3,4,5] | [-1,-1,1,2,3] |
Contenido relacionado
- Para desplazar una matriz a la derecha, use array_shift_right().
- Para girar una matriz a la derecha, use array_rotate_right().
- Para girar una matriz a la izquierda, use array_rotate_left().