Subversion Repositories Applications.framework

<?php
// declare(encoding='UTF-8');
/**
 * Classe fournissant des méthodes statiques de manipulation des tableaux (Array).
 *
 * @category    PHP 5.2
 * @package     Utilitaire
 * @author              Jean-Pascal MILCENT <jpm@tela-botanica.org>
 * @copyright   Copyright (c) 2009, 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$
 * @link                /doc/framework/
 */
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);
                }
        }
}
?>