28 lines
1.3 KiB
Groff
28 lines
1.3 KiB
Groff
.TH TERMKEY_CANONICALISE 3
|
|
.SH NAME
|
|
termkey_canonicalise \- canonicalise a key event
|
|
.SH SYNOPSIS
|
|
.nf
|
|
.B #include <termkey.h>
|
|
.sp
|
|
.BI "void termkey_canonicalise(TermKey *" tk ", TermKeyKey *" key );
|
|
.fi
|
|
.sp
|
|
Link with \fI-ltermkey\fP.
|
|
.SH DESCRIPTION
|
|
\fBtermkey_canonicalise\fP(3) modifies the key event structure given by \fIkey\fP according to the canonicalisation flags set on the given \fItk\fP instance. This operation is performed implicitly by \fBtermkey_getkey\fP(3), \fBtermkey_waitkey\fP(3) and \fBtermkey_strpkey\fP(3), and is also provided explicitly by this function.
|
|
.PP
|
|
The canonicalisation operation is affected by the following flags:
|
|
.TP
|
|
.B TERMKEY_CANON_SPACESYMBOL
|
|
If this flag is set then a Unicode space character is represented using the \fBTERMKEY_SYM_SPACE\fP symbol. If this flag is not set, it is represented by the U+0020 Unicode codepoint.
|
|
.TP
|
|
.B TERMKEY_CANON_DELBS
|
|
If this flag is set then an ASCII DEL character is represented by the \fBTERMKEY_SYM_BACKSPACE\fP symbol. If not, it is represented by \fBTERMKEY_SYM_DEL\fP. An ASCII BS character is always represented by \fBTERMKEY_SYM_BACKSPACE\fP, regardless of this flag.
|
|
.SH "RETURN VALUE"
|
|
\fBtermkey_canonicalise\fP() returns no value.
|
|
.SH "SEE ALSO"
|
|
.BR termkey_set_canonflags (3),
|
|
.BR termkey_waitkey (3),
|
|
.BR termkey_strpkey (3)
|