2 <BODY BGCOLOR="#99ccbb" TEXT="#000000" LINK="#4060b0" VLINK="#000080" ALINK="#ff4040">
4 <STRONG>define_key</STRONG> - define a keycode
9 <STRONG>#include</STRONG> <STRONG><curses.h></STRONG>
11 <STRONG>int</STRONG> <STRONG>define_key(char</STRONG> <STRONG>*definition,</STRONG> <STRONG>int</STRONG> <STRONG>keycode);</STRONG>
15 <H2>DESCRIPTION</H2><PRE>
16 This is an extension to the curses library. It permits an
17 application to define keycodes with their corresponding
18 control strings, so that the ncurses library will inter-
19 pret them just as it would the predefined codes in the
22 If the given string is null, any existing definition for
23 the keycode is removed.
27 <H2>RETURN VALUE</H2><PRE>
28 The keycode must be greater than zero, else ERR is
33 <H2>PORTABILITY</H2><PRE>
34 These routines are specific to ncurses. They were not
35 supported on Version 7, BSD or System V implementations.
36 It is recommended that any code depending on them be con-
37 ditioned using NCURSES_VERSION.
41 <H2>SEE ALSO</H2><PRE>
42 <STRONG><A HREF="keyok.3x.html">keyok(3X)</A></STRONG>.