1 |
<?php
|
1 |
<?php
|
2 |
// declare(encoding='UTF-8');
|
2 |
// declare(encoding='UTF-8');
|
3 |
/**
|
3 |
/**
|
4 |
* Classe fournissant des méthodes statiques de manipulation des tableaux (Array).
|
4 |
* Classe fournissant des méthodes statiques de manipulation des tableaux (Array).
|
5 |
*
|
5 |
*
|
6 |
* @category PHP 5.2
|
6 |
* @category PHP 5.2
|
7 |
* @package Utilitaire
|
7 |
* @package Utilitaire
|
8 |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
|
8 |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
|
9 |
* @copyright Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org)
|
9 |
* @copyright Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org)
|
10 |
* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL-v3
|
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
|
11 |
* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2
|
12 |
* @version $Id$
|
12 |
* @version $Id: Tableau.php 299 2011-01-18 14:03:46Z jpm $
|
13 |
* @link /doc/framework/
|
13 |
* @link /doc/framework/
|
14 |
*/
|
14 |
*/
|
15 |
class Tableau {
|
15 |
class Tableau {
|
16 |
/**
|
16 |
/**
|
17 |
* Etend le tableau à étendre avec les données du tableau à copier. Si des clés sont identiques entre les deux tableaux
|
17 |
* Etend le tableau à étendre avec les données du tableau à copier. Si des clés sont identiques entre les deux tableaux
|
18 |
* 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
|
18 |
* 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
|
19 |
* leurs valeurs sont gardées (à la différence de array_merge).
|
19 |
* leurs valeurs sont gardées (à la différence de array_merge).
|
20 |
* Les tableaux sont passés par références et le tableau à copier est progressivement détruit pour éviter la consomation
|
20 |
* Les tableaux sont passés par références et le tableau à copier est progressivement détruit pour éviter la consomation
|
21 |
* de mémoire.
|
21 |
* de mémoire.
|
22 |
*
|
22 |
*
|
23 |
* @param array $tableau_a_etendre
|
23 |
* @param array $tableau_a_etendre
|
24 |
* @param array $tableau_a_copier
|
24 |
* @param array $tableau_a_copier
|
25 |
* @return void
|
25 |
* @return void
|
26 |
*/
|
26 |
*/
|
27 |
public static function etendre(Array &$tableau_a_etendre, Array &$tableau_a_copier) {
|
27 |
public static function etendre(Array &$tableau_a_etendre, Array &$tableau_a_copier) {
|
28 |
$cles_existantes = null;
|
28 |
$cles_existantes = null;
|
29 |
foreach($tableau_a_copier as $cle => $val) {
|
29 |
foreach($tableau_a_copier as $cle => $val) {
|
30 |
if (!isset($tableau_a_etendre[$cle])) {
|
30 |
if (!isset($tableau_a_etendre[$cle])) {
|
31 |
$tableau_a_etendre[$cle] = $val;
|
31 |
$tableau_a_etendre[$cle] = $val;
|
32 |
unset($tableau_a_copier[$cle]);
|
32 |
unset($tableau_a_copier[$cle]);
|
33 |
} else {
|
33 |
} else {
|
34 |
$cles_existantes = $cle;
|
34 |
$cles_existantes = $cle;
|
35 |
}
|
35 |
}
|
36 |
}
|
36 |
}
|
37 |
if (is_array($cles_existantes)) {
|
37 |
if (is_array($cles_existantes)) {
|
38 |
$e = "Le tableau a étendre contenait déjà les clés suivantes : ".implode(', ', $cles_existantes);
|
38 |
$e = "Le tableau a étendre contenait déjà les clés suivantes : ".implode(', ', $cles_existantes);
|
39 |
trigger_error($e, E_USER_WARNING);
|
39 |
trigger_error($e, E_USER_WARNING);
|
40 |
}
|
40 |
}
|
41 |
}
|
41 |
}
|
42 |
}
|
42 |
}
|
43 |
?>
|
43 |
?>
|