array_shift_left()

Cambie los servicios mediante la lista desplegable Versión . Más información sobre la navegación.
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:

Ejecución de la consulta

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:

Ejecución de la consulta

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:

Ejecución de la consulta

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().