aboutsummaryrefslogtreecommitdiff
path: root/man/termkey_get_keyname.3
diff options
context:
space:
mode:
Diffstat (limited to 'man/termkey_get_keyname.3')
-rw-r--r--man/termkey_get_keyname.322
1 files changed, 22 insertions, 0 deletions
diff --git a/man/termkey_get_keyname.3 b/man/termkey_get_keyname.3
new file mode 100644
index 0000000..5f0119f
--- /dev/null
+++ b/man/termkey_get_keyname.3
@@ -0,0 +1,22 @@
+.TH TERMKEY_GET_KEYNAME 3
+.SH NAME
+termkey_get_keyname \- return a string name for a symbolic key
+.SH SYNOPSIS
+.nf
+.B #include <termkey.h>
+.sp
+.BI "const char *termkey_get_keyname(TermKey *" tk ", TermKeySym " sym );
+.fi
+.sp
+Link with \fI-ltermkey\fP.
+.SH DESCRIPTION
+\fBtermkey_get_keyname\fP() returns a human-readable string name for the symbolic key value given by \fBsym\fP. The returned string is owned by the termkey instance \fItk\fP so should not be modified or freed. The returned pointer is guaranteed to be valid until the termkey instance is released using \fBtermkey_destroy\fP(3). This function is the inverse of \fBtermkey_keyname2sym\fP(3).
+.SH "RETURN VALUE"
+\fBtermkey_get_key\fP() returns a pointer to a string.
+.SH "SEE ALSO"
+.BR termkey_new (3),
+.BR termkey_getkey (3),
+.BR termkey_waitkey (3),
+.BR termkey_lookup_keyname (3),
+.BR termkey_keyname2sym (3),
+.BR termkey_strfkey (3)