WebSVN – Applications.framework – Diff – /branches/v0.3-aleaume/framework/utilitaires/Tableau.php


<?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: Tableau.php 379 2011-10-14 09:11:52Z jpm $
 * @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);
		}
	}
	
	/**
	 * @deprecated Utiliser la méthode trierMD()
	 * @see  trierMD()
	 */
	public static function trierTableauMd($array, $cols) {
		return self::trierMD($array, $cols);
	}
	
	/**
	 * Permet de trier un tableau multi-dimenssionnel en gardant l'ordre des clés.
	 * 
	 * @param Array $array le tableau à trier
	 * @param Array $cols tableau indiquant en clé la colonne à trier et en valeur l'ordre avec SORT_ASC ou SORT_DESC
	 * @return Array le tableau trié.
	 * @author cagret at gmail dot com
	 * @see  http://fr.php.net/manual/fr/function.array-multisort.php Post du 21-Jun-2009 12:38
	 */
	public static function trierMD($array, $cols) {
		$colarr = array();
		foreach ($cols as $col => $order) {
		$colarr[$col] = array();
			foreach ($array as $k => $row) {
				$colarr[$col]['_'.$k] = strtolower($row[$col]);
			}
		}
		$params = array();
		foreach ($cols as $col => $order) {
			$params[] =& $colarr[$col];
			$params = array_merge($params, (array)$order);
		}
		call_user_func_array('array_multisort', $params);
		$ret = array();
		$keys = array();
		$first = true;
		foreach ($colarr as $col => $arr) {
			foreach ($arr as $k => $v) {
				if ($first) {
					$keys[$k] = substr($k, 1);
				}
				$k = $keys[$k];
				if (!isset($ret[$k])) {
					$ret[$k] = $array[$k];
				}
				$ret[$k][$col] = $array[$k][$col];
			}
			$first = false;
		}
		return $ret;
	}
}
?>

Rev 370	Rev 379
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: Tableau.php 370 2011-10-04 14:39:38Z jpm $`	12	`* @version $Id: Tableau.php 379 2011-10-14 09:11:52Z jpm $`
13	`* @link /doc/framework/`	13	`* @link /doc/framework/`
14	`*/`	14	`*/`
15	`class Tableau {`	15	`class Tableau {`
16		16
17	`/**`	17	`/**`
18	`* Etend le tableau à étendre avec les données du tableau à copier. Si des clés sont identiques entre les deux tableaux`	18	`* Etend le tableau à étendre avec les données du tableau à copier. Si des clés sont identiques entre les deux tableaux`
19	`* 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	`* 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`
20	`* leurs valeurs sont gardées (à la différence de array_merge).`	20	`* leurs valeurs sont gardées (à la différence de array_merge).`
21	`* Les tableaux sont passés par références et le tableau à copier est progressivement détruit pour éviter la consomation`	21	`* Les tableaux sont passés par références et le tableau à copier est progressivement détruit pour éviter la consomation`
22	`* de mémoire.`	22	`* de mémoire.`
23	`*`	23	`*`
24	`* @param array $tableau_a_etendre`	24	`* @param array $tableau_a_etendre`
25	`* @param array $tableau_a_copier`	25	`* @param array $tableau_a_copier`
26	`* @return void`	26	`* @return void`
27	`*/`	27	`*/`
28	`public static function etendre(Array &$tableau_a_etendre, Array &$tableau_a_copier) {`	28	`public static function etendre(Array &$tableau_a_etendre, Array &$tableau_a_copier) {`
29	`$cles_existantes = null;`	29	`$cles_existantes = null;`
30	`foreach($tableau_a_copier as $cle => $val) {`	30	`foreach($tableau_a_copier as $cle => $val) {`
31	`if (!isset($tableau_a_etendre[$cle])) {`	31	`if (!isset($tableau_a_etendre[$cle])) {`
32	`$tableau_a_etendre[$cle] = $val;`	32	`$tableau_a_etendre[$cle] = $val;`
33	`unset($tableau_a_copier[$cle]);`	33	`unset($tableau_a_copier[$cle]);`
34	`} else {`	34	`} else {`
35	`$cles_existantes = $cle;`	35	`$cles_existantes = $cle;`
36	`}`	36	`}`
37	`}`	37	`}`
38	`if (is_array($cles_existantes)) {`	38	`if (is_array($cles_existantes)) {`
39	`$e = "Le tableau a étendre contenait déjà les clés suivantes : ".implode(', ', $cles_existantes);`	39	`$e = "Le tableau a étendre contenait déjà les clés suivantes : ".implode(', ', $cles_existantes);`
40	`trigger_error($e, E_USER_WARNING);`	40	`trigger_error($e, E_USER_WARNING);`
41	`}`	41	`}`
42	`}`	42	`}`
43		43
44	`/**`	44	`/**`
-		45	`* @deprecated Utiliser la méthode trierMD()`
-		46	`* @see trierMD()`
-		47	`*/`
-		48	`public static function trierTableauMd($array, $cols) {`
-		49	`return self::trierMD($array, $cols);`
-		50	`}`
-		51
-		52	`/**`
45	`* Permet de trier un tableau multi-dimenssionnel en gardant l'ordre des clés.`	53	`* Permet de trier un tableau multi-dimenssionnel en gardant l'ordre des clés.`
46	`*`	54	`*`
47	`* @param Array $array le tableau à trier`	55	`* @param Array $array le tableau à trier`
48	`* @param Array $cols tableau indiquant en clé la colonne à trier et en valeur l'ordre avec SORT_ASC ou SORT_DESC`	56	`* @param Array $cols tableau indiquant en clé la colonne à trier et en valeur l'ordre avec SORT_ASC ou SORT_DESC`
49	`* @return Array le tableau trié.`	57	`* @return Array le tableau trié.`
50	`* @author cagret at gmail dot com`	58	`* @author cagret at gmail dot com`
51	`* @see http://fr.php.net/manual/fr/function.array-multisort.php Post du 21-Jun-2009 12:38`	59	`* @see http://fr.php.net/manual/fr/function.array-multisort.php Post du 21-Jun-2009 12:38`
52	`*/`	60	`*/`
53	`public static function trierTableauMd($array, $cols) {`	61	`public static function trierMD($array, $cols) {`
54	`$colarr = array();`	62	`$colarr = array();`
55	`foreach ($cols as $col => $order) {`	63	`foreach ($cols as $col => $order) {`
56	`$colarr[$col] = array();`	64	`$colarr[$col] = array();`
57	`foreach ($array as $k => $row) {`	65	`foreach ($array as $k => $row) {`
58	`$colarr[$col]['_'.$k] = strtolower($row[$col]);`	66	`$colarr[$col]['_'.$k] = strtolower($row[$col]);`
59	`}`	67	`}`
60	`}`	68	`}`
61	`$params = array();`	69	`$params = array();`
62	`foreach ($cols as $col => $order) {`	70	`foreach ($cols as $col => $order) {`
63	`$params[] =& $colarr[$col];`	71	`$params[] =& $colarr[$col];`
64	`$params = array_merge($params, (array)$order);`	72	`$params = array_merge($params, (array)$order);`
65	`}`	73	`}`
66	`call_user_func_array('array_multisort', $params);`	74	`call_user_func_array('array_multisort', $params);`
67	`$ret = array();`	75	`$ret = array();`
68	`$keys = array();`	76	`$keys = array();`
69	`$first = true;`	77	`$first = true;`
70	`foreach ($colarr as $col => $arr) {`	78	`foreach ($colarr as $col => $arr) {`
71	`foreach ($arr as $k => $v) {`	79	`foreach ($arr as $k => $v) {`
72	`if ($first) {`	80	`if ($first) {`
73	`$keys[$k] = substr($k, 1);`	81	`$keys[$k] = substr($k, 1);`
74	`}`	82	`}`
75	`$k = $keys[$k];`	83	`$k = $keys[$k];`
76	`if (!isset($ret[$k])) {`	84	`if (!isset($ret[$k])) {`
77	`$ret[$k] = $array[$k];`	85	`$ret[$k] = $array[$k];`
78	`}`	86	`}`
79	`$ret[$k][$col] = $array[$k][$col];`	87	`$ret[$k][$col] = $array[$k][$col];`
80	`}`	88	`}`
81	`$first = false;`	89	`$first = false;`
82	`}`	90	`}`
83	`return $ret;`	91	`return $ret;`
84	`}`	92	`}`
85	`}`	93	`}`
86	`?>`	94	`?>`

Subversion Repositories Applications.framework

(root)/branches/v0.3-aleaume/framework/utilitaires/Tableau.php – Rev 370 → 379