<?php
// declare(encoding='UTF-8');
/**
 * Classe fournissant des méthodes de manipulation de tableau (Array).
 *
 * @category	PHP 5.2
 * @package		eFlore/Bibliotheque
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
 * @copyright	Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
 * @license		http://www.gnu.org/licenses/gpl.html Licence GNU-GPL-v3
 * @license		http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2
 * @version		$Id$
 */
class TableauManipulateur {

	private $tableau = array();

	public function __construct(Array $tableau = null) {
		if (is_array($tableau)) {
			$this->setTableau($tableau);
		}
	}

	public function setTableau(Array $tableau) {
		$this->tableau = $tableau;
	}

	public function getTableau() {
		return $this->tableau;
	}

	/**
	* Etend le tableau principal avec les données du tableau à copier. Si des clés sont identiques entre les deux tableaux
	* une excetion 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).
	* Le tableau à copier est passé par copie et il est progressivement détruit pour éviter la consomation
	* de mémoire.
	*
	* @param array $tableau_a_copier
	* @return void
	*/
	public function etendreAvec(Array $tableau_a_copier) {
		$cles_existantes = null;
		foreach ($tableau_a_copier as $cle => $val) {
			if (array_key_exists($cle, $this->tableau) == false) {
				$this->tableau[$cle] = $val;
				unset($tableau_a_copier[$cle]);
			} else {
				$cles_existantes[] = $cle;
			}
		}
		if (is_array($cles_existantes)) {
			$message = "Le tableau a étendre contenait déjà les clés suivantes : ".implode(', ', $cles_existantes);
			throw new Exception($message);
		}
	}
}
?>