array_shift_left()

Desplaza los valores dentro de una matriz dinámica a la izquierda.

Syntax

array_shift_left(array, shift_count [,default_value ])

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Tipo	Requerido	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	escalar		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 eliminados tienen un valor de default_value.

Ejemplos

Desplazando 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]

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]

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