Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 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 esquerda. Se o valor for negativo, os elementos serão deslocados para a direita. |
| 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 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
O exemplo a seguir mostra a mudança para a esquerda por 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] |
O exemplo a seguir mostra a mudança 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)
Saída
| Arr | arr_shift |
|---|---|
| [1,2,3,4,5] | [3,4,5,-1,-1] |
O exemplo a seguir mostra a mudança 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)
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().