<?php
class Tableau {
	/**
	 * Etend le tableau à étendre avec les données du tableau à copier. Si des clés sont identiques entre les deux tableaux
	 * une erreur est déclenchée et la valeur du tableau à étendre est gardée. Si les deux tableaux ont des clés numériques 
	 * leurs valeurs sont gardées (à la différence de array_merge).
	 * Les tableaux sont passés par références et le tableau à copier est progressivement détruit pour éviter la consomation
	 * de mémoire.
	 * 
	 * @param array $tableau_a_etendre
	 * @param array $tableau_a_copier
	 * @return void
	 */
	public static function etendre(Array &$tableau_a_etendre, Array &$tableau_a_copier) {
		$cles_existantes = null;
		foreach ($tableau_a_copier as $cle => $val) {
			if (!isset($tableau_a_etendre[$cle])) {
				$tableau_a_etendre[$cle] = $val;
				unset($tableau_a_copier[$cle]);
			} else {
				$cles_existantes[] = $cle;
			}
		}
		if (is_array($cles_existantes)) {
			$e = "Le tableau a étendre contenait déjà les clés suivantes : ".implode(', ', $cles_existantes);
			trigger_error($e, E_USER_WARNING);
		}
	}
}
?>