array_shift_left()
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Desloca os valores dentro de uma matriz dinâmica para a esquerda.
Sintaxe
array_shift_left(array, 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 em 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 é nulo ou uma string 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 adicionados no lugar de elementos removidos têm um valor de default_value.
Exemplos
Deslocando-se para a esquerda em duas posições:
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] |
Deslocando para a esquerda em duas posições e adicionando o valor padrão:
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] |
Deslocar para a direita em duas posições usando o valor shift_count negativo:
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 um array 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().