array_shift_right()

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

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

Sintaxe

array_shift_right( matriz, shift_count [,default_value ])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

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

Devoluções

Retorna uma matriz dinâmica contendo a mesma quantidade de elementos que na matriz original. Cada elemento foi deslocado de acordo com shift_count. Novos elementos adicionados em vez dos elementos removidos têm um valor de default_value.

Exemplos

O exemplo a seguir mostra a mudança para a direita por duas posições:

Executar a consulta

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

Saída

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

O exemplo a seguir mostra a mudança para a direita por duas posições e a adição de um valor padrão:

Executar a consulta

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

Saída

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

O exemplo a seguir mostra a mudança para a esquerda por duas posições usando um valor de shift_count negativo:

Executar a consulta

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

Saída

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

Conteúdo relacionado

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