X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fdefine_key.3x.html;h=9ebd9c8836f51dbbb4c0a297f38e22de379f63ed;hb=e2153a14ebfb90265151d608778aaf9f403b3d24;hp=47aa7ac3a3aabe7737f5713fa96f142b6128ac1d;hpb=47d2fb4537d9ad5bb14f4810561a327930ca4280;p=ncurses.git diff --git a/doc/html/man/define_key.3x.html b/doc/html/man/define_key.3x.html index 47aa7ac3..9ebd9c88 100644 --- a/doc/html/man/define_key.3x.html +++ b/doc/html/man/define_key.3x.html @@ -1,6 +1,6 @@ - -define_key 3x +define_key 3x 2024-06-08 ncurses 6.5 Library calls - + -

define_key 3x

define_key 3x 2024-06-08 ncurses 6.5 Library calls

-define_key(3x)                                                  define_key(3x)
+define_key(3x)                   Library calls                  define_key(3x)

NAME

-       define_key - define a keycode
+       define_key - define a curses function key code

SYNOPSIS

        #include <curses.h>
 
-       int define_key(const char *definition, int keycode);
+       int define_key(const char * definition, int key-code);

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.
+       The define_key ncurses extension permits a curses application to bind a
+       string definition to the function key key-code returned  by  wgetch(3x)
+       (wide-character  API users: wget_wch(3x)) when keypad(3x) is enabled in
+       a window and a function key is  pressed.   ncurses  interprets  such  a
+       binding  as  it  does  those  in  the  terminfo  database entry for the
+       terminal type.
 
-       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.
+       A definition of  NULL  removes  any  existing  binding  from  key-code.
+       Similarly,  a  non-positive  key-code  removes  an existing binding for
+       definition, if any.

RETURN VALUE

-       The keycode must be greater than zero, and the string non-null,  other-
-       wise  ERR  is  returned.  ERR may also be returned if there is insuffi-
-       cient memory to allocate the data to store the definition.  If no error
-       is detected, OK is returned.
+       define_key returns ERR if
+
+       o   definition is NULL and key-code is nonpositive, or
+
+       o   insufficient memory is available to bind definition to key-code.
+
+       Otherwise, define_key returns OK.
+
+
+

EXTENSIONS

+       define_key is an ncurses extension.

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.
+       Applications employing ncurses extensions should condition their use on
+       the visibility of the NCURSES_VERSION preprocessor macro.
 
+       NetBSD curses since 2.0 (2004) supports define_key.
 
-

AUTHORS

+       Thomas Dickey
 
-

AUTHOR

-       Thomas Dickey.
+
+