UDF > Array >


_ArrayConcatenate

Concat�ne deux tableaux - tous les deux 1D ou 2D avec le m�me nombre de colonnes

#include <Array.au3>
_ArrayConcatenate ( ByRef $aArrayTarget, Const ByRef $aArraySource [, $iStart = 0] )

Param�tres

$aArrayTarget Le tableau auquel le tableau source sera concat�n�
$aArraySource Le tableau source � concat�ner au tableau cible
$iStart [optionnel] Index de la premi�re entr�e du tableau source (par d�faut, 0)

Valeur de retour

Succ�s: Retourne le nombre d'�l�mets/lignes du nouveau tableau cible
�chec: Retourne -1 et d�finit @error <> 0.
@error: 1 - $aArrayTarget n'est pas un tableau
2 - $aArraySource n'est pas un tableau
3 - $aArrayTarget n'est pas un tableau 1D ou 2D
4 - $aArrayTarget et $aArraySource 1D/2D ne correspondent pas
5 - $aArrayTarget et $aArraySource ont des nombres de colonne diff�rents (2D uniquement)
6 - $istart est hors des limites du tableau

Remarque

Le param�tre $iStart est utile lors de la concat�nation des tableaux qui ont leur nombre d'�l�ments en position [0].

La fonction ne met pas � jour l'�l�ment compteur du tableau cible, mais la valeur de retour de la fonction (si elle r�ussit) donne le nombre final de lignes dans le tableau r�sultant de la concat�nation.

En relation

_ArrayAdd

Exemple

#include <Array.au3>

Local $aArrayTarget[5] = ["0", "1", "2", "3", "4"]
Local $aArraySource[5] = ["5", "6", "7", "8", "9"]

_ArrayDisplay($aArrayTarget, "Cible 1D")
_ArrayDisplay($aArraySource, "Source 1D")
_ArrayConcatenate($aArrayTarget, $aArraySource)
_ArrayDisplay($aArrayTarget, "Cible et Source 1D concat�n�es")

Local $aArrayTarget[4][3]
For $i = 0 To 3
    For $j = 0 To 2
        $aArrayTarget[$i][$j] = String($i) & String($j)
    Next
Next

Local $aArraySource[4][3]
For $i = 0 To 3
    For $j = 0 To 2
        $aArraySource[$i][$j] = String(4 + $i) & String($j)
    Next
Next

_ArrayDisplay($aArrayTarget, "Cible 2D")
_ArrayDisplay($aArraySource, "Source 2D")
_ArrayConcatenate($aArrayTarget, $aArraySource)
_ArrayDisplay($aArrayTarget, "Cible et Source 2D concat�n�es")