array_merge_recursive
<<<		 array_merge array_multisort
>>>
8.3 Tableaux
8 Référence des fonctions
 Manuel PHP
. Introduction
. Pré-requis
. Installation
. Configuration à l'exécution
. Types de ressources
. Constantes pré-définies
. Voir aussi
. array_change_key_case
. array_chunk
. array_combine
. array_count_values
. array_diff_assoc
. array_diff_key
. array_diff_uassoc
. array_diff_ukey
. array_diff
. array_fill
. array_filter
. array_flip
. array_intersect_assoc
. array_intersect_key
. array_intersect_uassoc
. array_intersect_ukey
. array_intersect
. array_key_exists
. array_keys
. array_map
. array_merge_recursive
->array_merge
. array_multisort
. array_pad
. array_pop
. array_push
. array_rand
. array_reduce
. array_reverse
. array_search
. array_shift
. array_slice
. array_splice
. array_sum
. array_udiff_assoc
. array_udiff_uassoc
. array_udiff
. array_uintersect_assoc
. array_uintersect_uassoc
. array_uintersect
. array_unique
. array_unshift
. array_values
. array_walk_recursive
. array_walk
. array
. arsort
. asort
. compact
. count
. current
. each
. end
. extract
. in_array
. key
. krsort
. ksort
. list
. natcasesort
. natsort
. next
. pos
. prev
. range
. reset
. rsort
. shuffle
. sizeof
. sort
. uasort
. uksort
. usort

8.3.29 array_merge()Fusionne un ou plusieurs tableaux

[ Exemples avec array_merge ]   PHP 4 , PHP 5

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 avec array_merge

<?php
  $array1 = array ("couleur" => "rouge", 2, 4);
  $array2 = array ("a", "b", "couleur" => "vert", "forme" => "trapézoÔde");
  $result = array_merge ($array1, $array2);
  print_r($result);
?>

Exemple avec array_merge

<?php
  $array1 = array();
  $array2 = array(1 => "data");
  $result = array_merge($array1, $array2);
?>

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

<?php
  $array1 = array();
  $array2 = array(1 => "data");
  $result = $array1 + $array2;
?>
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);
?>

Note

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

Attention

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 avec array_merge en PHP 5

<?php
$beginning = 'foo';
$end = array(1 => 'bar');
$result = array_merge((array)$beginning, (array)$end);
?>

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

<< array_merge >>
array_merge_recursive Tableaux array_multisort