array_shift_right ()
array_shift_right()
déplace les valeurs à l'intérieur d'un tableau vers la droite.
Syntaxe
array_shift_right(
array, nombre_décalage [, valeur_remplissage ])
Arguments
- array: tableau d'entrée à décaler, doit être un tableau dynamique.
- shift_count: entier spécifiant le nombre de positions que les éléments de tableau seront décalés vers la droite. Si la valeur est négative, les éléments seront décalés vers la gauche.
- fill_value: valeur scalaire utilisée pour insérer des éléments au lieu de ceux qui ont été déplacés et supprimés. Valeur par défaut: valeur null ou chaîne vide (selon le type de tableau ).
Retours
Tableau dynamique contenant la même quantité 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 auront la valeur fill_value.
Voir aussi
- Pour le décalage du tableau vers la gauche, voir array_shift_left ().
- Pour la rotation du tableau à droite, voir array_rotate_right ().
- Pour le tableau tournant à gauche, voir array_rotate_left ().
Exemples
Déplacement vers la droite par deux positions:
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_right(arr, 2)
<p></p>
Les résultats
|arr |arr_shift |
|-----------|-----------------|
|[1,2,3,4,5]|[null,null,1,2,3]|
Déplacement vers la droite à l'aide de deux positions et ajout d'une valeur par défaut:
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_right(arr, 2, -1)
Les résultats
|arr |arr_shift |
|-----------|-------------|
|[1,2,3,4,5]|[-1,-1,1,2,3]|
- Déplacement vers la gauche de deux positions à l'aide d'une valeur shift_count négative:
print arr=dynamic([1,2,3,4,5])
| extend arr_shift=array_shift_right(arr, -2, -1)
Les résultats
|arr |arr_shift |
|-----------|-------------|
|[1,2,3,4,5]|[3,4,5,-1,-1]|