TERMKEY_LOOKUP_KEYNAME(3)TERMKEY_LOOKUP_KEYNAME(3)NAMEtermkey_lookup_keyname - look up a symbolic key value for a string name
SYNOPSIS
#include <termkey.h>
char *termkey_lookup_keyname(TermKey *tk, const char *keyname,
TermKeySym *sym);
Link with -ltermkey.
DESCRIPTIONtermkey_lookup_keyname() looks up the symbolic key value represented by
the given string name. This is a case-sensitive comparison. The sym‐
bolic value is written to the variable addressed by sym. This function
is a more general form of termkey_keyname2sym(3) because it can recog‐
nise a symbolic key name within a longer string, returning a pointer to
the remainder of the input after the key name.
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_lookup_keyname() returns a pointer to the first character after
a recognised name, or NULL if the string does not begin with the name
of a recognised symbolic key.
SEE ALSOtermkey_get_keyname(3), termkey_keyname2sym(3), termkey_strpkey(3),
termkey(7)TERMKEY_LOOKUP_KEYNAME(3)
