# udm_cat_list

(PHP 4 >= 4.0.6, PHP 5 < 5.1.0, PECL mnogosearch >= 1.0.0)

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

### 说明

udm_cat_list ( resource `$agent` , string `$category` ) : array

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

The function can be useful for developing categories tree browser.

### 参数

`agent`

  A link to Agent, received after call to udm_alloc_agent().

`category`

### 返回值

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.

### 范例

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

    Audi
      BMW
      Opel
      ...

Example #1 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 />";
     }
    ?>

### 参见

- udm_cat_path() - Get the path to the current category