Array_shift_left() (déplacement de tableau vers la gauche)

S’applique à : ✅Microsoft Fabric

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	Catégorie	Requise	Descriptif
tableau	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

L’exemple suivant montre le passage à 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]

L’exemple suivant montre le passage à gauche par deux positions et l’ajout de la 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]

L’exemple suivant montre le passage à droite par deux positions à l’aide d’une valeur 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 à 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().