Partilhar via


array_deslocar_para_esquerda()

Aplica-se a: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

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

Sintaxe

array_shift_left( matriz, shift_count [,default_value ])

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório 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 esquerda. Se o valor for negativo, os elementos são deslocados para a direita.
default_value escalar 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 contendo 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

O exemplo a seguir mostra o deslocamento para a esquerda por duas posições:

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

Realização

ARR arr_shift
[1,2,3,4,5] [3,4,5,null,null]

O exemplo a seguir mostra o deslocamento para a esquerda por duas posições e a adição do valor padrão:

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

Realização

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

O exemplo a seguir mostra o deslocamento para a direita por duas posições usando o valor de shift_count negativo:

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

Realização

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