ncurses 4.2
[ncurses.git] / Ada95 / html / menu_requestname.3x.html
1 <HTML>
2 <BODY BGCOLOR="#99ccbb" TEXT="#000000" LINK="#4060b0" VLINK="#000080" ALINK="#ff4040">
3 <PRE>
4        <STRONG>menu_requestname</STRONG> - handle printable menu request names
5
6
7 </PRE>
8 <H2>SYNOPSIS</H2><PRE>
9        <STRONG>#include</STRONG> <STRONG>&lt;menu.h&gt;</STRONG>
10        const char *menu_request_name(int request);
11        int menu_request_by_name(const char *name);
12
13
14 </PRE>
15 <H2>DESCRIPTION</H2><PRE>
16        The  function <STRONG>menu_request_name</STRONG> returns the printable name
17        of a menu request code.
18        The function <STRONG>menu_request_by_name</STRONG> searches  in  the  name-
19        table  for  a  request with the given name and returns its
20        request code. Otherwise E_NO_MATCH is returned.
21
22
23 </PRE>
24 <H2>RETURN VALUE</H2><PRE>
25        <STRONG>menu_request_name</STRONG> returns <STRONG>NULL</STRONG> on error and sets errno  to
26        <STRONG>E_BAD_ARGUMENT</STRONG>.
27        <STRONG>menu_request_by_name</STRONG> returns <STRONG>E_NO_MATCH</STRONG> on error.
28
29
30 </PRE>
31 <H2>SEE ALSO</H2><PRE>
32        <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG>, <STRONG><A HREF="menu.3x.html">menu(3X)</A></STRONG>.
33
34
35 </PRE>
36 <H2>NOTES</H2><PRE>
37        The header file <STRONG>&lt;menu.h&gt;</STRONG> automatically includes the header
38        file <STRONG>&lt;curses.h&gt;</STRONG>.
39
40
41 </PRE>
42 <H2>PORTABILITY</H2><PRE>
43        These routines are specific to  ncurses.   They  were  not
44        supported  on  Version 7, BSD or System V implementations.
45        It is recommended that any code depending on them be  con-
46        ditioned using NCURSES_VERSION.
47
48
49 </PRE>
50 <H2>AUTHORS</H2><PRE>
51        Juergen  Pfeifer.   Manual  pages  and  adaptation for new
52        curses by Eric S. Raymond.
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70 </PRE>
71 </BODY>
72 </HTML>