X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fdefine_key.3x.html;h=a0f81a5590f4daab34159aa078718b3494d474be;hb=HEAD;hp=ad69c118524fb13340cda4b6752822cd158be6dc;hpb=d90067f9008bb8338a77c1ed519bc108c275ed04;p=ncurses.git diff --git a/doc/html/man/define_key.3x.html b/doc/html/man/define_key.3x.html index ad69c118..8ca26d23 100644 --- a/doc/html/man/define_key.3x.html +++ b/doc/html/man/define_key.3x.html @@ -1,6 +1,6 @@ -define_key 3x 2023-12-16 ncurses 6.4 Library calls +define_key 3x 2024-05-25 ncurses 6.5 Library calls -

define_key 3x 2023-12-16 ncurses 6.4 Library calls

define_key 3x 2024-05-25 ncurses 6.5 Library calls

 define_key(3x)                   Library calls                  define_key(3x)
 
@@ -48,37 +48,47 @@

NAME

-       define_key - define a curses 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 definition is NULL, any existing one 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

-       Either keycode must be greater than zero, or definition  must  be  non-
-       NULL,  otherwise ERR is returned.  ERR may also be returned if there is
-       insufficient 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

@@ -86,11 +96,12 @@