definekey(3X) definekey(3X)

NAME
       ddeeffiinneekkeeyy - define a keycode

SYNOPSIS
       ##iinncclluuddee <>

       iinntt ddeeffiinneekkeeyy((ccoonnsstt cchhaarr **ddeeffiinniittiioonn,, iinntt kkeeyyccooddee));;

DESCRIPTION
       This  is an extension to the curses library.  It permits an application
       to define keycodes with their corresponding control  strings,  so  that
       the ncurses library will interpret them just as it would the predefined
       codes in the terminfo database.

       If the given string is null, any existing definition for the keycode is
       removed.   Similarly,  if  the  given  keycode is negative or zero, any
       existing string for the given definition is removed.

RREETTUURRNN VVAALLUUEE
       The keycode must be greater than zero, else ERR is returned.

PPOORRTTAABBIILLIITTYY
       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 NCURSESVERSION.

SEE ALSO
       kkeeyyookk(3X), kkeeyyddeeffiinneedd(3X).

AUTHOR       Thomas Dickey.



                                                                definekey(3X)