NAME

       termkey_keyname2sym - look up a symbolic key value for a string name

SYNOPSIS

       #include <termkey.h>

       TermKeySym termkey_keyname2sym(TermKey *tk, const char *keyname);

       Link with -ltermkey.

DESCRIPTION

       termkey_keyname2sym()  looks  up  the  symbolic  key value represented by the given string
       name.  This  is  a  case-sensitive  comparison.  If  the  given   name   is   not   found,
       TERMKEY_SYM_UNKNOWN   is   returned   instead.   This   function   is   the   inverse   of
       termkey_get_keyname(3), and is a more specific  form  of  termkey_lookup_keyname(3)  which
       only recognises names as complete strings.

       Because  the  key names are stored in an array indexed by the symbol number, this function
       has to perform a linear search of the names. Use of this function should be restricted  to
       converting  key  names  into  symbolic  values  during a program's initialisation, so that
       efficient comparisons can be done while it is running.

RETURN VALUE

       termkey_keyname2sym() returns a symbolic key constant, or TERMKEY_SYM_UNKNOWN.

SEE ALSO

       termkey_get_keyname(3), termkey_lookup_keyname(3), termkey_strpkey(3), termkey(7)

                                                                           TERMKEY_KEYNAME2SYM(3)