Writing a Key Filter Function

The call for your key filter function should be as follows:

int keyfilter_func(keycode)

int keycode;            /* Keycode read by ki()            */

ki() passes the keycode value to the key filter function. The keycode value can be either the keycode read from the keyboard buffer or a non-zero return from an installed keyloop function.

You should perform the required actions based on the keycode value passed.

Return 0 to have ki() discard the current keycode and begin the read sequence again. Return a non-zero value to have ki() return. If your key filter function returns a non-zero value, ki() returns this value.

Cautions: Do not call ki() in a key filter function.