Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TERMKEY_LOOKUP_KEYNAME(3)  Library Functions Manual  TERMKEY_LOOKUP_KEYNAME(3)

NAME
       termkey_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.

DESCRIPTION
       termkey_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 VALUE
       termkey_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 ALSO
       termkey_get_keyname(3),	 termkey_keyname2sym(3),   termkey_strpkey(3),
       termkey(7)

						     TERMKEY_LOOKUP_KEYNAME(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=termkey_lookup_keyname&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help