array_shift_left()

Desloca os valores dentro de uma matriz dinâmica para a esquerda.

Sintaxe

array_shift_left(matriz, shift_count [, default_value ])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Digitar	Obrigatória	Descrição
array	dynamic	✔️	A matriz a ser deslocada.
shift_count	int	✔️	O número de posições que os elementos da matriz são deslocados para a esquerda. Se o valor for negativo, os elementos serão deslocados para a direita.
default_value	scalar		O valor usado para um elemento que foi deslocado e removido. O padrão é null ou uma cadeia de caracteres vazia, dependendo do tipo de elementos na matriz.

Devoluções

Retorna uma matriz dinâmica que contém o mesmo número de elementos que na matriz original. Cada elemento foi deslocado de acordo com shift_count. Novos elementos que são adicionados no lugar de elementos removidos têm um valor de default_value.

Exemplos

Deslocamento para a esquerda por duas posições:

Executar a consulta

print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_left(arr, 2)

Saída

arr	arr_shift
[1,2,3,4,5]	[3,4,5,nulo,nulo]

Deslocamento para a esquerda por duas posições e adição de valor padrão:

Executar a consulta

print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_left(arr, 2, -1)

Saída

arr	arr_shift
[1,2,3,4,5]	[3,4,5,-1,-1]

Deslocamento para a direita por duas posições usando valor de shift_count negativo:

Executar a consulta

print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_left(arr, -2, -1)

Saída

arr	arr_shift
[1,2,3,4,5]	[-1,-1,1,2,3]

Conteúdo relacionado

• Para deslocar uma matriz para a direita, use array_shift_right().
• Para girar uma matriz para a direita, use array_rotate_right().
• Para girar uma matriz para a esquerda, use array_rotate_left().