Skip to content

menu_requestname(3x)

menu_request_by_name, menu_request_name - handle printable menu request names

#include <menu.h>
const char *menu_request_name(int request);
int menu_request_by_name(const char *name);

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. A request’s name is its constant without the REQ_ prefix, such as NEXT_ITEM, and the search ignores case.

menu_request_name returns NULL on error and sets errno to E_BAD_ARGUMENT.
menu_request_by_name returns E_NO_MATCH when no request has the given name, and sets errno to E_NO_MATCH.

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.

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

curses(3X), menu(3X)