2.4.10 Utility Functions

Function: int 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 1.3.1 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.