RTEMS GNU Tools On-Line Library

Utility Functions

GNU Readline Library

Function: int rl_read_key (): Return the next character available. This handles input inserted into the input stream via pending input (see Readline Variables) and rl_stuff_char (), macros, and characters read from the keyboard.

Function: int rl_getc (FILE *): Return the next character available from the keyboard.

Function: int rl_stuff_char (int c): Insert c into the Readline input stream. It will be "read" before Readline attempts to read characters from the terminal with rl_read_key ().

Function: 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 (): Initialize or re-initialize Readline's internal state.

Function: int rl_reset_terminal (char *terminal_name): Reinitialize Readline's idea of the terminal settings using terminal_name as the terminal type (e.g., vt100).

Function: int alphabetic (int c): Return 1 if c is an alphabetic character.

Function: int ding (): Ring the terminal bell, obeying the setting of bell-style.

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 Readline Init File Syntax).

The following are implemented as macros, defined in chartypes.h.

Function: int uppercase_p (int c): Return 1 if c is an uppercase alphabetic character.

Function: int lowercase_p (int c): Return 1 if c is a lowercase alphabetic character.

Function: int to_upper (int c): If c is a lowercase alphabetic character, return the corresponding uppercase character.

Function: int to_lower (int c): If c is an uppercase alphabetic character, return the corresponding lowercase character.

Function: int digit_value (int c): If c is a number, return the value it represents.

GNU Readline Library