termo/termkey_get_keyname.3

22 lines
878 B
Groff
Raw Normal View History

.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_t *" tk ", termkey_keysym " sym );
.fi
.sp
Link with \fI-ltermkey\fP.
.SH DESCRIPTION
2008-12-02 01:56:43 +01:00
\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),
2008-12-02 01:56:43 +01:00
.BR termkey_keyname2sym (3),
.BR termkey_snprint_key (3)