Subversion Repositories eFlore/Applications.eflore-consultation

<?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);
                }
        }
}
?>