2.4.2 Selecting a Keymap

Key bindings take place on a keymap. The keymap is the association between the keys that the user types and the functions that get run. You can make your own keymaps, copy existing keymaps, and tell Readline which keymap to use.

Function: Keymap rl_make_bare_keymap (void)

Returns a new, empty keymap. The space for the keymap is allocated with malloc(); the caller should free it by calling rl_free_keymap() when done.

Function: Keymap rl_copy_keymap (Keymap map)

Return a new keymap which is a copy of map.

Function: Keymap rl_make_keymap (void)

Return a new keymap with the printing characters bound to rl_insert, the lowercase Meta characters bound to run their equivalents, and the Meta digits bound to produce numeric arguments.

Function: void rl_discard_keymap (Keymap keymap)

Free the storage associated with the data in keymap. The caller should free keymap.

Function: void rl_free_keymap (Keymap keymap)

Free all storage associated with keymap. This calls rl_discard_keymap to free subordindate keymaps and macros.

Readline has several internal keymaps. These functions allow you to change which keymap is active.

Function: Keymap rl_get_keymap (void)

Returns the currently active keymap.

Function: void rl_set_keymap (Keymap keymap)

Makes keymap the currently active keymap.

Function: Keymap rl_get_keymap_by_name (const char *name)

Return the keymap matching name. name is one which would be supplied in a set keymap inputrc line (see section Readline Init File).

Function: char * rl_get_keymap_name (Keymap keymap)

Return the name matching keymap. name is one which would be supplied in a set keymap inputrc line (see section Readline Init File).