udm_cat_list

Get all the categories on the same level with the current one

&reftitle.description; `array` `udm_cat_list` `resource` `agent` `string` `category`

Gets all the categories on the same level with the current one.

The function can be useful for developing categories tree browser.

&reftitle.parameters;

`agent`

- A link to Agent, received after call to `udm_alloc_agent`.

`category`

&reftitle.returnvalues;

Returns an array listing all categories of the same level as the current `category` in the categories tree.

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

      $array[0] will contain '020300'
      $array[1] will contain 'Audi'
      $array[2] will contain '020301'
      $array[3] will contain 'BMW'
      $array[4] will contain '020302'
      $array[5] will contain 'Opel'
      ...
     etc.

&reftitle.examples;

Following is an example of displaying links of the current level in format:

      Audi
      BMW
      Opel
      ...

### `udm_cat_list`example

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

&reftitle.seealso;

- `udm_cat_path`