system/libraries/URI.php - code-igniter-v3-giggi - Gitiles

 <?php  if (!defined('BASEPATH')) exit('No direct script access allowed');
 /**
  * CodeIgniter
  *
  * An open source application development framework for PHP 4.3.2 or newer
  *
  * @package		CodeIgniter
  * @author		ExpressionEngine Dev Team
  * @copyright	Copyright (c) 2006, EllisLab, Inc.
  * @license		http://codeigniter.com/user_guide/license.html
  * @link		http://codeigniter.com
  * @since		Version 1.0
  * @filesource
  */

 // ------------------------------------------------------------------------

 /**
  * URI Class
  *
  * Parses URIs and determines routing
  *
  * @package		CodeIgniter
  * @subpackage	Libraries
  * @category	URI
  * @author		ExpressionEngine Dev Team
  * @link		http://codeigniter.com/user_guide/libraries/uri.html
  */
 class CI_URI {

 	var	$keyval	= array();
 	var $uri_string;
 	var $segments		= array();
 	var $rsegments		= array();

 	/**
 	 * Constructor
 	 *
 	 * Simply globalizes the $RTR object.  The front
 	 * loads the Router class early on so it's not available
 	 * normally as other classes are.
 	 *
 	 * @access	public
 	 */
 	function CI_URI()
 	{
 		$this->config =& load_class('Config');
 		log_message('debug', "URI Class Initialized");
 	}


 	// --------------------------------------------------------------------

 	/**
 	 * Get the URI String
 	 *
 	 * @access	private
 	 * @return	string
 	 */
 	function _fetch_uri_string()
 	{
 		if (strtoupper($this->config->item('uri_protocol')) == 'AUTO')
 		{
 			// If the URL has a question mark then it's simplest to just
 			// build the URI string from the zero index of the $_GET array.
 			// This avoids having to deal with $_SERVER variables, which
 			// can be unreliable in some environments
 			if (is_array($_GET) AND count($_GET) == 1)
 			{
 				// Note: Due to a bug in current() that affects some versions
 				// of PHP we can not pass function call directly into it
 				$key = array_keys($_GET);
 				$index = current($key);
 				$this->uri_string = $_GET[$index];
 				return;
 			}

 			// Is there a PATH_INFO variable?
 			// Note: some servers seem to have trouble with getenv() so we'll test it two ways
 			$path = (isset($_SERVER['PATH_INFO'])) ? $_SERVER['PATH_INFO'] : @getenv('PATH_INFO');
 			if ($path != '' AND $path != '/' AND $path != "/".SELF)
 			{
 				$this->uri_string = $path;
 				return;
 			}

 			// No PATH_INFO?... What about QUERY_STRING?
 			$path =  (isset($_SERVER['QUERY_STRING'])) ? $_SERVER['QUERY_STRING'] : @getenv('QUERY_STRING');
 			if ($path != '' AND $path != '/')
 			{
 				$this->uri_string = $path;
 				return;
 			}

 			// No QUERY_STRING?... Maybe the ORIG_PATH_INFO variable exists?
 			$path = (isset($_SERVER['ORIG_PATH_INFO'])) ? $_SERVER['ORIG_PATH_INFO'] : @getenv('ORIG_PATH_INFO');
 			if ($path != '' AND $path != '/' AND $path != "/".SELF)
 			{
 				$this->uri_string = $path;
 				return;
 			}

 			// We've exhausted all our options...
 			$this->uri_string = '';
 		}
 		else
 		{
 			$uri = strtoupper($this->config->item('uri_protocol'));

 			if ($uri == 'REQUEST_URI')
 			{
 				$this->uri_string = $this->_parse_request_uri();
 				return;
 			}

 			$this->uri_string = (isset($_SERVER[$uri])) ? $_SERVER[$uri] : @getenv($uri);
 		}

 		// If the URI contains only a slash we'll kill it
 		if ($this->uri_string == '/')
 		{
 			$this->uri_string = '';
 		}
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Parse the REQUEST_URI
 	 *
 	 * Due to the way REQUEST_URI works it usually contains path info
 	 * that makes it unusable as URI data.  We'll trim off the unnecessary
 	 * data, hopefully arriving at a valid URI that we can use.
 	 *
 	 * @access	private
 	 * @return	string
 	 */
 	function _parse_request_uri()
 	{
 		if ( ! isset($_SERVER['REQUEST_URI']) OR $_SERVER['REQUEST_URI'] == '')
 		{
 			return '';
 		}

 		$request_uri = preg_replace("|/(.*)|", "\\1", str_replace("\\", "/", $_SERVER['REQUEST_URI']));

 		if ($request_uri == '' OR $request_uri == SELF)
 		{
 			return '';
 		}

 		$fc_path = FCPATH;
 		if (strpos($request_uri, '?') !== FALSE)
 		{
 			$fc_path .= '?';
 		}

 		$parsed_uri = explode("/", $request_uri);

 		$i = 0;
 		foreach(explode("/", $fc_path) as $segment)
 		{
 			if (isset($parsed_uri[$i]) AND $segment == $parsed_uri[$i])
 			{
 				$i++;
 			}
 		}

 		$parsed_uri = implode("/", array_slice($parsed_uri, $i));

 		if ($parsed_uri != '')
 		{
 			$parsed_uri = '/'.$parsed_uri;
 		}

 		return $parsed_uri;
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Filter segments for malicious characters
 	 *
 	 * @access	private
 	 * @param	string
 	 * @return	string
 	 */
 	function _filter_uri($str)
 	{
 		if ($str != '' AND $this->config->item('permitted_uri_chars') != '')
 		{
 			if ( ! preg_match("|^[".preg_quote($this->config->item('permitted_uri_chars'))."]+$|i", $str))
 			{
 				exit('The URI you submitted has disallowed characters.');
 			}
 		}

 		return $str;
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Remove the suffix from the URL if needed
 	 *
 	 * @access	private
 	 * @return	void
 	 */
 	function _remove_url_suffix()
 	{
 		if  ($this->config->item('url_suffix') != "")
 		{
 			$this->uri_string = preg_replace("|".preg_quote($this->config->item('url_suffix'))."$|", "", $this->uri_string);
 		}
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Explode the URI Segments. The individual segments will
 	 * be stored in the $this->segments array.
 	 *
 	 * @access	private
 	 * @return	void
 	 */
 	function _explode_segments()
 	{
 		foreach(explode("/", preg_replace("|/*(.+?)/*$|", "\\1", $this->uri_string)) as $val)
 		{
 			// Filter segments for security
 			$val = trim($this->_filter_uri($val));

 			if ($val != '')
 				$this->segments[] = $val;
 		}
 	}

 	// --------------------------------------------------------------------
 	/**
 	 * Re-index Segments
 	 *
 	 * This function re-indexes the $this->segment array so that it
 	 * starts at 1 rather then 0.  Doing so makes it simpler to
 	 * use functions like $this->uri->segment(n) since there is
 	 * a 1:1 relationship between the segment array and the actual segments.
 	 *
 	 * @access	private
 	 * @return	void
 	 */
 	function _reindex_segments()
 	{
 		// Is the routed segment array different then the main segment array?
 		$diff = (count(array_diff($this->rsegments, $this->segments)) == 0) ? FALSE : TRUE;

 		$i = 1;
 		foreach ($this->segments as $val)
 		{
 			$this->segments[$i++] = $val;
 		}
 		unset($this->segments[0]);

 		if ($diff == FALSE)
 		{
 			$this->rsegments = $this->segments;
 		}
 		else
 		{
 			$i = 1;
 			foreach ($this->rsegments as $val)
 			{
 				$this->rsegments[$i++] = $val;
 			}
 			unset($this->rsegments[0]);
 		}
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Fetch a URI Segment
 	 *
 	 * This function returns the URI segment based on the number provided.
 	 *
 	 * @access	public
 	 * @param	integer
 	 * @param	bool
 	 * @return	string
 	 */
 	function segment($n, $no_result = FALSE)
 	{
 		return ( ! isset($this->segments[$n])) ? $no_result : $this->segments[$n];
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Fetch a URI "routed" Segment
 	 *
 	 * This function returns the re-routed URI segment (assuming routing rules are used)
 	 * based on the number provided.  If there is no routing this function returns the
 	 * same result as $this->segment()
 	 *
 	 * @access	public
 	 * @param	integer
 	 * @param	bool
 	 * @return	string
 	 */
 	function rsegment($n, $no_result = FALSE)
 	{
 		return ( ! isset($this->rsegments[$n])) ? $no_result : $this->rsegments[$n];
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Generate a key value pair from the URI string
 	 *
 	 * This function generates and associative array of URI data starting
 	 * at the supplied segment. For example, if this is your URI:
 	 *
 	 *	www.your-site.com/user/search/name/joe/location/UK/gender/male
 	 *
 	 * You can use this function to generate an array with this prototype:
 	 *
 	 * array (
 	 *			name => joe
 	 *			location => UK
 	 *			gender => male
 	 *		 )
 	 *
 	 * @access	public
 	 * @param	integer	the starting segment number
 	 * @param	array	an array of default values
 	 * @return	array
 	 */
 	function uri_to_assoc($n = 3, $default = array())
 	{
 	 	return $this->_uri_to_assoc($n, $default, 'segment');
 	}
 	/**
 	 * Identical to above only it uses the re-routed segment array
 	 *
 	 */
 	function ruri_to_assoc($n = 3, $default = array())
 	{
 	 	return $this->_uri_to_assoc($n, $default, 'rsegment');
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Generate a key value pair from the URI string or Re-routed URI string
 	 *
 	 * @access	private
 	 * @param	integer	the starting segment number
 	 * @param	array	an array of default values
 	 * @param	string	which array we should use
 	 * @return	array
 	 */
 	function _uri_to_assoc($n = 3, $default = array(), $which = 'segment')
 	{
 		if ($which == 'segment')
 		{
 			$total_segments = 'total_segments';
 			$segment_array = 'segment_array';
 		}
 		else
 		{
 			$total_segments = 'total_rsegments';
 			$segment_array = 'rsegment_array';
 		}

 		if ( ! is_numeric($n))
 		{
 			return $default;
 		}

 		if (isset($this->keyval[$n]))
 		{
 			return $this->keyval[$n];
 		}

 		if ($this->$total_segments() < $n)
 		{
 			if (count($default) == 0)
 			{
 				return array();
 			}

 			$retval = array();
 			foreach ($default as $val)
 			{
 				$retval[$val] = FALSE;
 			}
 			return $retval;
 		}

 		$segments = array_slice($this->$segment_array(), ($n - 1));

 		$i = 0;
 		$lastval = '';
 		$retval  = array();
 		foreach ($segments as $seg)
 		{
 			if ($i % 2)
 			{
 				$retval[$lastval] = $seg;
 			}
 			else
 			{
 				$retval[$seg] = FALSE;
 				$lastval = $seg;
 			}

 			$i++;
 		}

 		if (count($default) > 0)
 		{
 			foreach ($default as $val)
 			{
 				if ( ! array_key_exists($val, $retval))
 				{
 					$retval[$val] = FALSE;
 				}
 			}
 		}

 		// Cache the array for reuse
 		$this->keyval[$n] = $retval;
 		return $retval;
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Generate a URI string from an associative array
 	 *
 	 *
 	 * @access	public
 	 * @param	array	an associative array of key/values
 	 * @return	array
 	 */
 	function assoc_to_uri($array)
 	{
 		$temp = array();
 		foreach ((array)$array as $key => $val)
 		{
 			$temp[] = $key;
 			$temp[] = $val;
 		}

 		return implode('/', $temp);
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Fetch a URI Segment and add a trailing slash
 	 *
 	 * @access	public
 	 * @param	integer
 	 * @param	string
 	 * @return	string
 	 */
 	function slash_segment($n, $where = 'trailing')
 	{
 		return $this->_slash_segment($n, $where, 'segment');
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Fetch a URI Segment and add a trailing slash
 	 *
 	 * @access	public
 	 * @param	integer
 	 * @param	string
 	 * @return	string
 	 */
 	function slash_rsegment($n, $where = 'trailing')
 	{
 		return $this->_slash_segment($n, $where, 'rsegment');
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Fetch a URI Segment and add a trailing slash - helper function
 	 *
 	 * @access	private
 	 * @param	integer
 	 * @param	string
 	 * @param	string
 	 * @return	string
 	 */
 	function _slash_segment($n, $where = 'trailing', $which = 'segment')
 	{
 		if ($where == 'trailing')
 		{
 			$trailing	= '/';
 			$leading	= '';
 		}
 		elseif ($where == 'leading')
 		{
 			$leading	= '/';
 			$trailing	= '';
 		}
 		else
 		{
 			$leading	= '/';
 			$trailing	= '/';
 		}
 		return $leading.$this->$which($n).$trailing;
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Segment Array
 	 *
 	 * @access	public
 	 * @return	array
 	 */
 	function segment_array()
 	{
 		return $this->segments;
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Routed Segment Array
 	 *
 	 * @access	public
 	 * @return	array
 	 */
 	function rsegment_array()
 	{
 		return $this->rsegments;
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Total number of segments
 	 *
 	 * @access	public
 	 * @return	integer
 	 */
 	function total_segments()
 	{
 		return count($this->segments);
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Total number of routed segments
 	 *
 	 * @access	public
 	 * @return	integer
 	 */
 	function total_rsegments()
 	{
 		return count($this->rsegments);
 	}

 	// --------------------------------------------------------------------

 	/**
 	 * Fetch the entire URI string
 	 *
 	 * @access	public
 	 * @return	string
 	 */
 	function uri_string()
 	{
 		return $this->uri_string;
 	}


 	// --------------------------------------------------------------------

 	/**
 	 * Fetch the entire Re-routed URI string
 	 *
 	 * @access	public
 	 * @return	string
 	 */
 	function ruri_string()
 	{
 		return '/'.implode('/', $this->rsegment_array()).'/';
 	}

 }
 // END URI Class
 ?>
	<?php if (!defined('BASEPATH')) exit('No direct script access allowed');
	/**
	* CodeIgniter
	*
	* An open source application development framework for PHP 4.3.2 or newer
	*
	* @package CodeIgniter
	* @author ExpressionEngine Dev Team
	* @copyright Copyright (c) 2006, EllisLab, Inc.
	* @license http://codeigniter.com/user_guide/license.html
	* @link http://codeigniter.com
	* @since Version 1.0
	* @filesource
	*/

	// ------------------------------------------------------------------------

	/**
	* URI Class
	*
	* Parses URIs and determines routing
	*
	* @package CodeIgniter
	* @subpackage Libraries
	* @category URI
	* @author ExpressionEngine Dev Team
	* @link http://codeigniter.com/user_guide/libraries/uri.html
	*/
	class CI_URI {

	var $keyval = array();
	var $uri_string;
	var $segments = array();
	var $rsegments = array();

	/**
	* Constructor
	*
	* Simply globalizes the $RTR object. The front
	* loads the Router class early on so it's not available
	* normally as other classes are.
	*
	* @access public
	*/
	function CI_URI()
	{
	$this->config =& load_class('Config');
	log_message('debug', "URI Class Initialized");
	}


	// --------------------------------------------------------------------

	/**
	* Get the URI String
	*
	* @access private
	* @return string
	*/
	function _fetch_uri_string()
	{
	if (strtoupper($this->config->item('uri_protocol')) == 'AUTO')
	{
	// If the URL has a question mark then it's simplest to just
	// build the URI string from the zero index of the $_GET array.
	// This avoids having to deal with $_SERVER variables, which
	// can be unreliable in some environments
	if (is_array($_GET) AND count($_GET) == 1)
	{
	// Note: Due to a bug in current() that affects some versions
	// of PHP we can not pass function call directly into it
	$key = array_keys($_GET);
	$index = current($key);
	$this->uri_string = $_GET[$index];
	return;
	}

	// Is there a PATH_INFO variable?
	// Note: some servers seem to have trouble with getenv() so we'll test it two ways
	$path = (isset($_SERVER['PATH_INFO'])) ? $_SERVER['PATH_INFO'] : @getenv('PATH_INFO');
	if ($path != '' AND $path != '/' AND $path != "/".SELF)
	{
	$this->uri_string = $path;
	return;
	}

	// No PATH_INFO?... What about QUERY_STRING?
	$path = (isset($_SERVER['QUERY_STRING'])) ? $_SERVER['QUERY_STRING'] : @getenv('QUERY_STRING');
	if ($path != '' AND $path != '/')
	{
	$this->uri_string = $path;
	return;
	}

	// No QUERY_STRING?... Maybe the ORIG_PATH_INFO variable exists?
	$path = (isset($_SERVER['ORIG_PATH_INFO'])) ? $_SERVER['ORIG_PATH_INFO'] : @getenv('ORIG_PATH_INFO');
	if ($path != '' AND $path != '/' AND $path != "/".SELF)
	{
	$this->uri_string = $path;
	return;
	}

	// We've exhausted all our options...
	$this->uri_string = '';
	}
	else
	{
	$uri = strtoupper($this->config->item('uri_protocol'));

	if ($uri == 'REQUEST_URI')
	{
	$this->uri_string = $this->_parse_request_uri();
	return;
	}

	$this->uri_string = (isset($_SERVER[$uri])) ? $_SERVER[$uri] : @getenv($uri);
	}

	// If the URI contains only a slash we'll kill it
	if ($this->uri_string == '/')
	{
	$this->uri_string = '';
	}
	}

	// --------------------------------------------------------------------

	/**
	* Parse the REQUEST_URI
	*
	* Due to the way REQUEST_URI works it usually contains path info
	* that makes it unusable as URI data. We'll trim off the unnecessary
	* data, hopefully arriving at a valid URI that we can use.
	*
	* @access private
	* @return string
	*/
	function _parse_request_uri()
	{
	if ( ! isset($_SERVER['REQUEST_URI']) OR $_SERVER['REQUEST_URI'] == '')
	{
	return '';
	}

	$request_uri = preg_replace("\|/(.*)\|", "\\1", str_replace("\\", "/", $_SERVER['REQUEST_URI']));

	if ($request_uri == '' OR $request_uri == SELF)
	{
	return '';
	}

	$fc_path = FCPATH;
	if (strpos($request_uri, '?') !== FALSE)
	{
	$fc_path .= '?';
	}

	$parsed_uri = explode("/", $request_uri);

	$i = 0;
	foreach(explode("/", $fc_path) as $segment)
	{
	if (isset($parsed_uri[$i]) AND $segment == $parsed_uri[$i])
	{
	$i++;
	}
	}

	$parsed_uri = implode("/", array_slice($parsed_uri, $i));

	if ($parsed_uri != '')
	{
	$parsed_uri = '/'.$parsed_uri;
	}

	return $parsed_uri;
	}

	// --------------------------------------------------------------------

	/**
	* Filter segments for malicious characters
	*
	* @access private
	* @param string
	* @return string
	*/
	function _filter_uri($str)
	{
	if ($str != '' AND $this->config->item('permitted_uri_chars') != '')
	{
	if ( ! preg_match("\|^[".preg_quote($this->config->item('permitted_uri_chars'))."]+$\|i", $str))
	{
	exit('The URI you submitted has disallowed characters.');
	}
	}

	return $str;
	}

	// --------------------------------------------------------------------

	/**
	* Remove the suffix from the URL if needed
	*
	* @access private
	* @return void
	*/
	function _remove_url_suffix()
	{
	if ($this->config->item('url_suffix') != "")
	{
	$this->uri_string = preg_replace("\|".preg_quote($this->config->item('url_suffix'))."$\|", "", $this->uri_string);
	}
	}

	// --------------------------------------------------------------------

	/**
	* Explode the URI Segments. The individual segments will
	* be stored in the $this->segments array.
	*
	* @access private
	* @return void
	*/
	function _explode_segments()
	{
	foreach(explode("/", preg_replace("\|/(.+?)/$\|", "\\1", $this->uri_string)) as $val)
	{
	// Filter segments for security
	$val = trim($this->_filter_uri($val));

	if ($val != '')
	$this->segments[] = $val;
	}
	}

	// --------------------------------------------------------------------
	/**
	* Re-index Segments
	*
	* This function re-indexes the $this->segment array so that it
	* starts at 1 rather then 0. Doing so makes it simpler to
	* use functions like $this->uri->segment(n) since there is
	* a 1:1 relationship between the segment array and the actual segments.
	*
	* @access private
	* @return void
	*/
	function _reindex_segments()
	{
	// Is the routed segment array different then the main segment array?
	$diff = (count(array_diff($this->rsegments, $this->segments)) == 0) ? FALSE : TRUE;

	$i = 1;
	foreach ($this->segments as $val)
	{
	$this->segments[$i++] = $val;
	}
	unset($this->segments[0]);

	if ($diff == FALSE)
	{
	$this->rsegments = $this->segments;
	}
	else
	{
	$i = 1;
	foreach ($this->rsegments as $val)
	{
	$this->rsegments[$i++] = $val;
	}
	unset($this->rsegments[0]);
	}
	}

	// --------------------------------------------------------------------

	/**
	* Fetch a URI Segment
	*
	* This function returns the URI segment based on the number provided.
	*
	* @access public
	* @param integer
	* @param bool
	* @return string
	*/
	function segment($n, $no_result = FALSE)
	{
	return ( ! isset($this->segments[$n])) ? $no_result : $this->segments[$n];
	}

	// --------------------------------------------------------------------

	/**
	* Fetch a URI "routed" Segment
	*
	* This function returns the re-routed URI segment (assuming routing rules are used)
	* based on the number provided. If there is no routing this function returns the
	* same result as $this->segment()
	*
	* @access public
	* @param integer
	* @param bool
	* @return string
	*/
	function rsegment($n, $no_result = FALSE)
	{
	return ( ! isset($this->rsegments[$n])) ? $no_result : $this->rsegments[$n];
	}

	// --------------------------------------------------------------------

	/**
	* Generate a key value pair from the URI string
	*
	* This function generates and associative array of URI data starting
	* at the supplied segment. For example, if this is your URI:
	*
	* www.your-site.com/user/search/name/joe/location/UK/gender/male
	*
	* You can use this function to generate an array with this prototype:
	*
	* array (
	* name => joe
	* location => UK
	* gender => male
	* )
	*
	* @access public
	* @param integer the starting segment number
	* @param array an array of default values
	* @return array
	*/
	function uri_to_assoc($n = 3, $default = array())
	{
	return $this->_uri_to_assoc($n, $default, 'segment');
	}
	/**
	* Identical to above only it uses the re-routed segment array
	*
	*/
	function ruri_to_assoc($n = 3, $default = array())
	{
	return $this->_uri_to_assoc($n, $default, 'rsegment');
	}

	// --------------------------------------------------------------------

	/**
	* Generate a key value pair from the URI string or Re-routed URI string
	*
	* @access private
	* @param integer the starting segment number
	* @param array an array of default values
	* @param string which array we should use
	* @return array
	*/
	function _uri_to_assoc($n = 3, $default = array(), $which = 'segment')
	{
	if ($which == 'segment')
	{
	$total_segments = 'total_segments';
	$segment_array = 'segment_array';
	}
	else
	{
	$total_segments = 'total_rsegments';
	$segment_array = 'rsegment_array';
	}

	if ( ! is_numeric($n))
	{
	return $default;
	}

	if (isset($this->keyval[$n]))
	{
	return $this->keyval[$n];
	}

	if ($this->$total_segments() < $n)
	{
	if (count($default) == 0)
	{
	return array();
	}

	$retval = array();
	foreach ($default as $val)
	{
	$retval[$val] = FALSE;
	}
	return $retval;
	}

	$segments = array_slice($this->$segment_array(), ($n - 1));

	$i = 0;
	$lastval = '';
	$retval = array();
	foreach ($segments as $seg)
	{
	if ($i % 2)
	{
	$retval[$lastval] = $seg;
	}
	else
	{
	$retval[$seg] = FALSE;
	$lastval = $seg;
	}

	$i++;
	}

	if (count($default) > 0)
	{
	foreach ($default as $val)
	{
	if ( ! array_key_exists($val, $retval))
	{
	$retval[$val] = FALSE;
	}
	}
	}

	// Cache the array for reuse
	$this->keyval[$n] = $retval;
	return $retval;
	}

	// --------------------------------------------------------------------

	/**
	* Generate a URI string from an associative array
	*
	*
	* @access public
	* @param array an associative array of key/values
	* @return array
	*/
	function assoc_to_uri($array)
	{
	$temp = array();
	foreach ((array)$array as $key => $val)
	{
	$temp[] = $key;
	$temp[] = $val;
	}

	return implode('/', $temp);
	}

	// --------------------------------------------------------------------

	/**
	* Fetch a URI Segment and add a trailing slash
	*
	* @access public
	* @param integer
	* @param string
	* @return string
	*/
	function slash_segment($n, $where = 'trailing')
	{
	return $this->_slash_segment($n, $where, 'segment');
	}

	// --------------------------------------------------------------------

	/**
	* Fetch a URI Segment and add a trailing slash
	*
	* @access public
	* @param integer
	* @param string
	* @return string
	*/
	function slash_rsegment($n, $where = 'trailing')
	{
	return $this->_slash_segment($n, $where, 'rsegment');
	}

	// --------------------------------------------------------------------

	/**
	* Fetch a URI Segment and add a trailing slash - helper function
	*
	* @access private
	* @param integer
	* @param string
	* @param string
	* @return string
	*/
	function _slash_segment($n, $where = 'trailing', $which = 'segment')
	{
	if ($where == 'trailing')
	{
	$trailing = '/';
	$leading = '';
	}
	elseif ($where == 'leading')
	{
	$leading = '/';
	$trailing = '';
	}
	else
	{
	$leading = '/';
	$trailing = '/';
	}
	return $leading.$this->$which($n).$trailing;
	}

	// --------------------------------------------------------------------

	/**
	* Segment Array
	*
	* @access public
	* @return array
	*/
	function segment_array()
	{
	return $this->segments;
	}

	// --------------------------------------------------------------------

	/**
	* Routed Segment Array
	*
	* @access public
	* @return array
	*/
	function rsegment_array()
	{
	return $this->rsegments;
	}

	// --------------------------------------------------------------------

	/**
	* Total number of segments
	*
	* @access public
	* @return integer
	*/
	function total_segments()
	{
	return count($this->segments);
	}

	// --------------------------------------------------------------------

	/**
	* Total number of routed segments
	*
	* @access public
	* @return integer
	*/
	function total_rsegments()
	{
	return count($this->rsegments);
	}

	// --------------------------------------------------------------------

	/**
	* Fetch the entire URI string
	*
	* @access public
	* @return string
	*/
	function uri_string()
	{
	return $this->uri_string;
	}


	// --------------------------------------------------------------------

	/**
	* Fetch the entire Re-routed URI string
	*
	* @access public
	* @return string
	*/
	function ruri_string()
	{
	return '/'.implode('/', $this->rsegment_array()).'/';
	}

	}
	// END URI Class
	?>