Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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(
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] |
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().