From 082b49f0f8790e2cf98346a03c53f492d9d5dcba Mon Sep 17 00:00:00 2001 From: Paul LeoNerd Evans Date: Wed, 18 Jan 2012 12:01:38 +0000 Subject: Move the growing collection of manpages into their own man/ subdirectory --- man/termkey_lookup_keyname.3 | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 man/termkey_lookup_keyname.3 (limited to 'man/termkey_lookup_keyname.3') diff --git a/man/termkey_lookup_keyname.3 b/man/termkey_lookup_keyname.3 new file mode 100644 index 0000000..bd44411 --- /dev/null +++ b/man/termkey_lookup_keyname.3 @@ -0,0 +1,23 @@ +.TH TERMKEY_LOOKUP_KEYNAME 3 +.SH NAME +termkey_lookup_keyname \- look up a symbolic key value for a string name +.SH SYNOPSIS +.nf +.B #include +.sp +.BI "char *termkey_lookup_keyname(TermKey *" tk ", const char *" keyname ", +.BI " TermKeySym *" sym "); +.fi +.sp +Link with \fI-ltermkey\fP. +.SH DESCRIPTION +\fBtermkey_lookup_keyname\fP() looks up the symbolic key value represented by the given string name. This is a case-sensitive comparison. The symbolic value is written to the variable addressed by \fIsym\fP. This function is a more general form of \fBtermkey_keyname2sym\fP(3) because it can recognise a symbolic key name within a longer string, returning a pointer to the remainder of the input after the key name. +.PP +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. +.SH "RETURN VALUE" +\fBtermkey_lookup_keyname\fP() returns a pointer to the first character after a recognised name, or \fBNULL\fP if the string does not begin with the name of a recognised symbolic key. +.SH "SEE ALSO" +.BR termkey_new (3), +.BR termkey_get_keyname (3), +.BR termkey_keyname2sym (3), +.BR termkey_strpkey (3) -- cgit v1.2.3