TERMKEY_KEYNAME2SYM(3)TERMKEY_KEYNAME2SYM(3)NAMEtermkey_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.
DESCRIPTIONtermkey_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 spe‐
cific 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 num‐
ber, this function has to perform a linear search of the names. Use of
this function should be restricted to converting key names into sym‐
bolic values during a program's initialisation, so that efficient com‐
parisons can be done while it is running.
RETURN VALUEtermkey_keyname2sym() returns a symbolic key constant, or
TERMKEY_SYM_UNKNOWN.
SEE ALSOtermkey_get_keyname(3), termkey_lookup_keyname(3), termkey_strpkey(3),
termkey(7)TERMKEY_KEYNAME2SYM(3)