function menu_get_item in Drupal 4

Same name and namespace in other branches

1. 5 includes/menu.inc \menu_get_item()
2. 6 includes/menu.inc \menu_get_item()
3. 7 includes/menu.inc \menu_get_item()

Retrieves the menu item specified by $mid, or by $path if $mid is not given.

Parameters

$mid: The menu ID of the menu item to retrieve.

$path: The internal path of the menu item to retrieve. Defaults to NULL. Only used if $mid is not set.

$reset: Optional flag that resets the static variable cache of the menu tree, if set to TRUE. Default is FALSE.

Return value

The menu item found in the site menu, or an empty array if none could be found.

Related topics

13 calls to menu_get_item()

menu_block in modules/menu.module

Implementation of hook_block().

menu_disable_item in modules/menu.module

Menu callback; hide a menu item.

menu_get_active_breadcrumb in includes/menu.inc

Returns an array of rendered menu items in the active breadcrumb trail.

menu_get_active_nontask_item in includes/menu.inc

Returns the ID of the current menu item or, if the current item is a local task, the menu item to which this task is attached.

menu_get_active_title in includes/menu.inc

Returns the title of the active menu item.

... See full list

File

includes/menu.inc, line 271

API for the Drupal menu system.

Code

function menu_get_item($mid, $path = NULL, $reset = FALSE) {
  static $menu;
  if (!isset($menu) || $reset) {
    $menu = menu_get_menu();
  }
  if (isset($mid)) {
    return $menu['items'][$mid];
  }
  if (isset($path)) {
    return $menu['items'][$menu['path index'][$path]];
  }
  return array();
}