Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| de matriz | 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
En el ejemplo siguiente se muestra cómo cambiar 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] |
En el ejemplo siguiente se muestra cómo cambiar 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] |
En el ejemplo siguiente se muestra cómo cambiar 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().