Subversion Repositories Applications.framework

Rev

Rev 299 | Rev 370 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
220 jpm 1
<?php
2
// declare(encoding='UTF-8');
3
/**
4
 * Classe fournissant des méthodes statiques de manipulation des tableaux (Array).
5
 *
6
 * @category	PHP 5.2
7
 * @package	Utilitaire
8
 * @author		Jean-Pascal MILCENT <jpm@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
11
 * @license	http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2
240 jpm 12
 * @version	$Id: Tableau.php 363 2011-09-06 15:47:26Z jpm $
220 jpm 13
 * @link		/doc/framework/
14
 */
15
class Tableau {
16
	/**
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
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
21
	 * de mémoire.
22
	 *
23
	 * @param array $tableau_a_etendre
24
	 * @param array $tableau_a_copier
25
	 * @return void
26
	 */
27
	public static function etendre(Array &$tableau_a_etendre, Array &$tableau_a_copier) {
28
		$cles_existantes = null;
29
		foreach($tableau_a_copier as $cle => $val) {
30
			if (!isset($tableau_a_etendre[$cle])) {
31
				$tableau_a_etendre[$cle] = $val;
32
				unset($tableau_a_copier[$cle]);
33
			} else {
34
				$cles_existantes = $cle;
35
			}
36
		}
37
		if (is_array($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);
40
		}
41
	}
363 jpm 42
 
43
	/**
44
	 * Permet de trier un tableau multi-dimenssionnel en gardant l'ordre des clés.
45
	 *
46
	 * @param Array $array le tableau à trier
47
	 * @param Array $cols tableau indiquant en clé la colonne à trier et en valeur l'ordre avec SORT_ASC ou SORT_DESC
48
	 * @author cagret at gmail dot com
49
	 * @see  http://fr.php.net/manual/fr/function.array-multisort.php Post du 21-Jun-2009 12:38
50
	 */
51
	public static function trierTableauMd($array, $cols) {
52
		$colarr = array();
53
		foreach ($cols as $col => $order) {
54
		$colarr[$col] = array();
55
			foreach ($array as $k => $row) {
56
				$colarr[$col]['_'.$k] = strtolower($row[$col]);
57
			}
58
		}
59
		$params = array();
60
		foreach ($cols as $col => $order) {
61
			$params[] =& $colarr[$col];
62
			$params = array_merge($params, (array)$order);
63
		}
64
		call_user_func_array('array_multisort', $params);
65
		$ret = array();
66
		$keys = array();
67
		$first = true;
68
		foreach ($colarr as $col => $arr) {
69
			foreach ($arr as $k => $v) {
70
				if ($first) {
71
					$keys[$k] = substr($k, 1);
72
				}
73
				$k = $keys[$k];
74
				if (!isset($ret[$k])) {
75
					$ret[$k] = $array[$k];
76
				}
77
				$ret[$k][$col] = $array[$k][$col];
78
			}
79
			$first = false;
80
		}
81
		return $ret;
82
	}
220 jpm 83
}
84
?>