2.4.10 Utility Functions

Function: int rl_save_state (struct readline_state *sp)

Save a snapshot of Readline's internal state to sp. The contents of the readline_state structure are documented in ‘readline.h’. The caller is responsible for allocating the structure.

Function: int rl_restore_state (struct readline_state *sp)

Restore Readline's internal state to that stored in sp, which must have been saved by a call to rl_save_state. The contents of the readline_state structure are documented in ‘readline.h’. The caller is responsible for freeing the structure.

Function: void rl_free (void *mem)

Deallocate the memory pointed to by mem. mem must have been allocated by malloc.

Function: void rl_replace_line (const char *text, int clear_undo)

Replace the contents of rl_line_buffer with text. The point and mark are preserved, if possible. If clear_undo is non-zero, the undo list associated with the current line is cleared.

Function: void rl_extend_line_buffer (int len)

Ensure that rl_line_buffer has enough space to hold len characters, possibly reallocating it if necessary.

Function: int rl_initialize (void)

Initialize or re-initialize Readline's internal state. It's not strictly necessary to call this; readline() calls it before reading any input.

Function: int rl_ding (void)

Ring the terminal bell, obeying the setting of bell-style.

Function: int rl_alphabetic (int c)

Return 1 if c is an alphabetic character.

Function: void rl_display_match_list (char **matches, int len, int max)

A convenience function for displaying a list of strings in columnar format on Readline's output stream. matches is the list of strings, in argv format, such as a list of completion matches. len is the number of strings in matches, and max is the length of the longest string in matches. This function uses the setting of print-completions-horizontally to select how the matches are displayed (see section Readline Init File Syntax).

The following are implemented as macros, defined in chardefs.h. Applications should refrain from using them.

Function: int _rl_uppercase_p (int c)

Return 1 if c is an uppercase alphabetic character.

Function: int _rl_lowercase_p (int c)

Return 1 if c is a lowercase alphabetic character.

Function: int _rl_digit_p (int c)

Return 1 if c is a numeric character.

Function: int _rl_to_upper (int c)

If c is a lowercase alphabetic character, return the corresponding uppercase character.

Function: int _rl_to_lower (int c)

If c is an uppercase alphabetic character, return the corresponding lowercase character.

Function: int _rl_digit_value (int c)

If c is a number, return the value it represents.