UDF > Array >


_ArrayPush

Ins�re de nouvelles valeurs � la fin en supprimant autant de valeurs au d�but (taille inchang�e) ou inversement

#include <Array.au3>
_ArrayPush ( ByRef $aArray, $vValue [, $iDirection = 0] )

Param�tres

$aArray Tableau � modifier
$vValue Valeur(s) � ins�rer (peuvent �tre dans un tableau)
$iDirection [optionnel] Direction du glissement des �l�ments du tableau:
    0 = Glissement vers la gauche (insertion � la fin)
    1 = Glissement vers la droite (insertion au d�but)

Valeur de retour

Succ�s: Retourne 1.
�chec: Retourne 0 et d�finit @error <> 0.
@error: 1 - $aArray n'est pas un tableau
2 - $vValeur est un tableau plus grand que $aArray (il ne peut pas s'adapter)
3 - $aArray n'est pas un tableau 1D

Remarque

Cette fonction est utilis�e pour les mises � jour en continu des donn�es d'un tableau, ou sinon un tableau de grande taille serait cr��.
Il conserve toutes les valeurs � l'int�rieur du tableau (quelque chose comme History), moins les premiers ou les derniers, selon la direction choisie.
La fonction est similaire � la commande 'push' en assembleur.

En relation

_ArrayAdd, _ArrayConcatenate, _ArrayDelete, _ArrayInsert, _ArrayPop

Exemple

#include <Array.au3>

Local $avArrayTarget[9] = [1, 2, 3, 4, 5, 6, 7, 8, 9]
Local $avArraySource[2] = [100, 200]

_ArrayDisplay($avArrayTarget, "$avArrayTarget AVANT _ArrayPush()")
_ArrayPush($avArrayTarget, $avArraySource)
_ArrayDisplay($avArrayTarget, "$avArrayTarget APRES _ArrayPush() avec un tableau � la fin")
_ArrayPush($avArrayTarget, $avArraySource, 1)
_ArrayDisplay($avArrayTarget, "$avArrayTarget APRES _ArrayPush() avec un tableau au d�but")
_ArrayPush($avArrayTarget, "Bonjour � tous!", 1)
_ArrayDisplay($avArrayTarget, "$avArrayTarget APRES _ArrayPush() avec une cha�ne au d�but")