Manuel PHP
Précédent |  | Suivant

# array_merge

(PHP 4 , PHP 5)

array_merge -- Fusionne un ou plusieurs tableaux

## Description

array array_merge ( array array1 [, array array2 [, array ...]] )

array_merge() rassemble les éléments d'un ou de plusieurs tableaux array1, array2, ... ensemble, en ajoutant les valeurs de l'un à la fin de l'autre. Le résultat est un tableau.

Si les tableaux ont des clés en commun, la dernière valeur rencontrée écrasera l'ancienne. Pour les valeurs numériques, cela n'arrive pas, car alors, les valeurs sont ajoutées en fin de tableau.

Si vous passez un seul tableau à cette fonction et qu'il a des indices numériques, les clefs seront réindexées normalement. Pour les tableaux associatifs, les entrées dupliquées seront fusionnées dans la dernière. Voyez le troisième exemple pour plus de détails.

Exemple 1. Exemple avec array_merge()
`<?php $array1 = array ("couleur" => "rouge", 2, 4); $array2 = array ("a", "b", "couleur" => "vert", "forme" => "trapézo&Ocirc;de"); $result = array_merge ($array1, $array2); print_r($result); ?>`
L'exemple ci-dessus va afficher :
`Array ( [couleur] => vert [0] => 2 [1] => 4 [2] => a [3] => b [forme] => trapézo&Ocirc;de )`

Exemple 2. Exemple avec array_merge()
`<?php $array1 = array(); $array2 = array(1 => "data"); $result = array_merge($array1, $array2); ?>`
N'oubliez pas que les index numériques seront renumérotés.
`Array ( [0] => data )`

Si vous voulez préserver complètement les tableaux, et que vous souhaitez simplement les ajouter les uns aux autres, utilisez l'opérateur + :

Exemple 3.
`<?php $array1 = array(); $array2 = array(1 => "data"); $result = $array1 + $array2; ?>`
Les index numériques seront préservés. D'où le résultat :
`Array ( [1] => data )`

Exemple 4. Exemple avec array_merge() (3)
`<?php $array_one = array(0 => "gui", 1 => "ghis", 2 => "bob", 3 => "dams"); $array_two = array("dams" => "bob", "gui" => "ghis", "dams" => "didou"); unset($array_one[2]); $result_one = array_merge($array_one); $result_two = array_merge($array_two); print_r($result_one); print_r($result_two); ?>`
L'exemple ci-dessus va afficher :
`Array ( [0] => gui [1] => ghis [2] => dams ) Array ( [dams] => didou [gui] => ghis )`

> Note : Les clés communes seront écrasées successivement par les clés identiques suivantes.

Avertissement
Le comportement de array_merge() a été modifié en PHP 5. Contrairement à PHP 4, array_merge() n'accepte que des paramètres de type array. Cependant, vous pouvez utiliser le transtypage pour fusionner les autres de types de valeurs. Voyez l'exemple ci-dessous.
Exemple 5. Exemple avec array_merge() en PHP 5
`<?php $beginning = 'foo'; $end = array(1 => 'bar'); $result = array_merge((array)$beginning, (array)$end); ?>`
L'exemple ci-dessus va afficher :
`Array ( [0] => foo [1] => bar )`

Voir aussi array_merge_recursive(), array_combine() et les opérateurs de tableaux.

Précédent | Sommaire | Suivant
array_merge_recursive | Niveau supérieur | array_multisort