<?
	
	/**
	 * Classe utilitária com métodos que auxiliam operações com Arrays
	 */
	class ArrayUtils {
		
		/**
		 * Ordena um array no esquema do ORDER BY SQL
		 *
		 * @param Array $array O array que será organizado
		 * @param String $by Campo pelo qual o array será organizado
		 * @param String $order Tipo de organização (ASC ou DESC)
		 * @param String $type Organização numérica ou por string
		 * @return Array
		 */
		function orderBy($array, $by, $order, $type) {				      
			$sortby = "sort$by"; //This sets up what you are sorting by
			
			$firstval = current($array); //Pulls over the first array
			
			$vals = array_keys($firstval); //Grabs the associate Arrays
			
			foreach ($vals as $init){
			   $keyname = "sort$init";
			   $$keyname = array();
			}
			//This was strange because I had problems adding
			//Multiple arrays into a variable variable
			//I got it to work by initializing the variable variables as arrays
			//Before I went any further
			
			foreach ($array as $key => $row) {
			  
			foreach ($vals as $names){
			   $keyname = "sort$names";
			   $test = array();
			   $test[$key] = $row[$names];
			   $$keyname = array_merge($$keyname,$test);
			  
			}
			
			}
			
			//This will create dynamic mini arrays so that I can perform
			//the array multisort with no problem
			//Notice the temp array... I had to do that because I
			//cannot assign additional array elements to a
			//varaiable variable           
			
			if ($order == "DESC"){   
			if ($type == "num"){
			array_multisort($$sortby,SORT_DESC, SORT_NUMERIC,$array);
			} else {
			array_multisort($$sortby,SORT_DESC, SORT_STRING,$array);
			}
			} else {
			if ($type == "num"){
			array_multisort($$sortby,SORT_ASC, SORT_NUMERIC,$array);
			} else {
			array_multisort($$sortby,SORT_ASC, SORT_STRING,$array);
			}
			}
			
			//This just goed through and asks the additional arguments
			//What they are doing and are doing variations of
			//the multisort
			
			return $array;
		}

		
		
		/**
		 * Converte um array do tipo Chave/Valor
		 * para uma array do tipo Lista, unindo a Chave 
		 * ao Valor com um separador definido no parâmetro $Separator
		 *
		 * @param Array $KeyValueArray Array do tipo chave valor que será convertido
		 * @param String $Separator String usada para separar os elementos
		 * @param String $Delimiter String usada para delimitar os elementos
		 * @return Boolean
		 */
		function keyValueArrayToList($KeyValueArray, $Separator = " = ", $Delimiter = "'") {
			$listArray = array();
			
			foreach ($KeyValueArray as $key => $value) {
				$listArray[] = $key . $Separator . $Delimiter . $value . $Delimiter;
			}
			
			return $listArray;
		}
		
		
		
		/**
		 * Converte um array do tipo Chave/Valor
		 * para um array do tipo Lista de Parâmetros (usada em 
		 * instruções SQL), no formato "nome_do_campo = ?".
		 * Os valores são passados no parâmetro de saída $OutputValues
		 *
		 * @param Array $KeyValueArray Array do tipo chave valor que será convertido
		 * @param Array $OutputValues (Parâmetro de Saída) Array que guardará os valores extraídos
		 * @param String $ParameterChar Caractere que representa o parâmetro
		 * @return Array
		 */
		function keyValueArrayToParameteredList($KeyValueArray, &$OutputValues, $ParameterChar = "?") {
			$listArray = array();
			$valuesArray = array();
			
			foreach ($KeyValueArray as $key => $value) {
				$listArray[] = $key . " = " . $ParameterChar;
				$valuesArray[] = $value;
			}
			
			$OutputValues = $valuesArray;			
			return $listArray;
		}
		
	}
	
?>