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")