php man page for udm_cat_path

UDM_CAT_PATH(3) 							 1							   UDM_CAT_PATH(3)

udm_cat_path - Get the path to the current category

SYNOPSIS
       array udm_cat_path (resource  $agent, string  $category)

DESCRIPTION
	Returns an array describing the path in the categories tree from the tree root to the current one, specified by $category.

PARAMETERS
	      o $agent
		- A link to Agent, received after call to udm_alloc_agent(3).

	      o $category
		-

RETURN VALUES
	The  returned array consists of pairs. Elements with even index numbers contain the category paths, odd elements contain the corresponding
       category names.

	For example, the call $array=udm_cat_path($agent, '02031D'); may return the following array:

       $array[0] will contain ''
	$array[1] will contain 'Root'
	$array[2] will contain '02'
	$array[3] will contain 'Sport'
	$array[4] will contain '0203'
	$array[5] will contain 'Auto'
	$array[4] will contain '02031D'
	$array[5] will contain 'Ferrari'

EXAMPLES
       Example #1

	       Specifying path to the current category in the following format: '> Root > Sport > Auto > Ferrari'

	      <?php
		$cat_path_arr = udm_cat_path($udm_agent, $cat);
		$cat_path = '';
		for ($i=0; $i<count($cat_path_arr); $i+=2) {
		  $path = $cat_path_arr[$i];
		  $name = $cat_path_arr[$i+1];
		  $cat_path .= " > <a href="$_SERVER[PHP_SELF]?cat=$path">$name</a> ";
		}
	      ?>

SEE ALSO
       udm_cat_list(3).

PHP Documentation Group 													   UDM_CAT_PATH(3)