Subversion Repositories eFlore/Applications.eflore-consultation

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
147 jpm 1
<?php
2
// declare(encoding='UTF-8');
3
/**
4
 * Classe fournissant des méthodes de manipulation de tableau (Array).
5
 *
6
 * @category	PHP 5.2
7
 * @package		eFlore/Bibliotheque
8
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
9
 * @copyright	Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
10
 * @license		http://www.gnu.org/licenses/gpl.html Licence GNU-GPL-v3
11
 * @license		http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2
12
 * @version		$Id$
13
 */
14
class TableauManipulateur {
15
 
16
	private $tableau = array();
17
 
18
	public function __construct(Array $tableau = null) {
19
		if (is_array($tableau)) {
20
			$this->setTableau($tableau);
21
		}
22
	}
23
 
24
	public function setTableau(Array $tableau) {
25
		$this->tableau = $tableau;
26
	}
27
 
28
	public function getTableau() {
29
		return $this->tableau;
30
	}
31
 
32
	/**
33
	* Etend le tableau principal avec les données du tableau à copier. Si des clés sont identiques entre les deux tableaux
34
	* 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
35
	* leurs valeurs sont gardées (à la différence de array_merge).
36
	* Le tableau à copier est passé par copie et il est progressivement détruit pour éviter la consomation
37
	* de mémoire.
38
	*
39
	* @param array $tableau_a_copier
40
	* @return void
41
	*/
42
	public function etendreAvec(Array $tableau_a_copier) {
43
		$cles_existantes = null;
44
		foreach ($tableau_a_copier as $cle => $val) {
45
			if (array_key_exists($cle, $this->tableau) == false) {
46
				$this->tableau[$cle] = $val;
47
				unset($tableau_a_copier[$cle]);
48
			} else {
49
				$cles_existantes[] = $cle;
50
			}
51
		}
52
		if (is_array($cles_existantes)) {
53
			$message = "Le tableau a étendre contenait déjà les clés suivantes : ".implode(', ', $cles_existantes);
54
			throw new Exception($message);
55
		}
56
	}
57
}
58
?>