array_shift_left()
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Déplace les valeurs à l’intérieur d’un tableau dynamique vers la gauche.
Syntaxe
array_shift_left(array, shift_count [, default_value ])
En savoir plus sur les conventions de syntaxe.
Paramètres
| Nom | Type | Requise | Description |
|---|---|---|---|
| array | dynamic |
✔️ | Tableau à déplacer. |
| shift_count | int |
✔️ | Nombre de positions que les éléments de tableau sont décalés vers la gauche. Si la valeur est négative, les éléments sont déplacés vers la droite. |
| default_value | scalaire | Valeur utilisée pour un élément qui a été décalé et supprimé. La valeur par défaut est Null ou une chaîne vide en fonction du type d’éléments dans le tableau. |
Retours
Retourne un tableau dynamique contenant le même nombre d’éléments que dans le tableau d’origine. Chaque élément a été décalé en fonction de shift_count. Les nouveaux éléments ajoutés à la place des éléments supprimés ont une valeur de default_value.
Exemples
Passage à gauche par deux positions :
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_left(arr, 2)
Sortie
| arr | arr_shift |
|---|---|
| [1,2,3,4,5] | [3,4,5,null,null] |
Passer à gauche par deux positions et ajouter une valeur par défaut :
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_left(arr, 2, -1)
Sortie
| arr | arr_shift |
|---|---|
| [1,2,3,4,5] | [3,4,5,-1,-1] |
Passage à droite par deux positions à l’aide d’une valeur de shift_count négative :
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_left(arr, -2, -1)
Sortie
| arr | arr_shift |
|---|---|
| [1,2,3,4,5] | [-1,-1,1,2,3] |
Contenu connexe
- Pour déplacer un tableau à droite, utilisez array_shift_right().
- Pour faire pivoter un tableau à droite, utilisez array_rotate_right().
- Pour faire pivoter un tableau vers la gauche, utilisez array_rotate_left().