menu_requestname(3)

menu_requestname3

Handle printable menu request names

Part of menu_request_by_name(3).

Usage

#include <menu.h>

const char *menu_request_name(int request); int menu_request_by_name(const char *name);

Overview

The function menu_request_name returns the printable name of a menu request code.
The function menu_request_by_name searches in the name-table for a request with the given name and returns its request code. Otherwise E_NO_MATCH is returned.

Return value

menu_request_name returns NULL on error and sets errno to E_BAD_ARGUMENT.
menu_request_by_name returns E_NO_MATCH on error. It does not set errno.

Portability

These routines are specific to ncurses. They were not supported on Version 7, BSD or System V implementations. It is recommended that any code depending on them be conditioned using NCURSES_VERSION.

Releases

66 releases since FreeBSD 4.3-RELEASE; the text changed 8 times.

  1. 4.3–6.2
  2. 6.3–10.4
  3. 11.0–12.4
  4. 13.0–13.5
  5. 14.0–14.1
  6. 14.2–14.4
  7. 14.5
  8. 15.0
  9. 15.1–16.0

Authors

Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's man source.