array_shift_right()

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:

Ejecución de la consulta

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:

Ejecución de la consulta

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:

Ejecución de la consulta

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