array_shift_left()

Déplace les valeurs à l’intérieur d’un tableau dynamique vers la gauche.

Syntax

array_shift_left(tableau, shift_count [,default_value ])

Découvrez les conventions de syntaxe.

Paramètres

Nom	Type	Obligatoire	Description
array	dynamic	✔️	Tableau à déplacer.
shift_count	int	✔️	Nombre de positions que les éléments du tableau sont déplacé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éplacé 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

Déplacement vers la gauche par deux positions :

Exécuter la requête

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]

Déplacement vers la gauche de deux positions et ajout de valeur par défaut :

Exécuter la requête

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]

Déplacement vers la droite de deux positions à l’aide d’une valeur de shift_count négative :

Exécuter la requête

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 vers la droite, utilisez array_shift_right().
• Pour faire pivoter un tableau vers la droite, utilisez array_rotate_right().
• Pour faire pivoter un tableau vers la gauche, utilisez array_rotate_left().