www.delorie.com/gnu/docs/readline/rlman_35.html

search

	Buy GNU books!

GNU Readline Library

2.4.6 Redisplay

Function: void rl_redisplay (void)

Change what's displayed on the screen to reflect the current contents of rl_line_buffer.

Function: int rl_forced_update_display (void)

Force the line to be updated and redisplayed, whether or not Readline thinks the screen display is correct.

Function: int rl_on_new_line (void)

Tell the update functions that we have moved onto a new (empty) line, usually after ouputting a newline.

Function: int rl_on_new_line_with_prompt (void)

Tell the update functions that we have moved onto a new line, with rl_prompt already displayed. This could be used by applications that want to output the prompt string themselves, but still need Readline to know the prompt string length for redisplay. It should be used after setting rl_already_prompted.

Function: int rl_reset_line_state (void)

Reset the display state to a clean state and redisplay the current line starting on a new line.

Function: int rl_crlf (void)

Move the cursor to the start of the next screen line.

Function: int rl_show_char (int c)

Display character c on rl_outstream. If Readline has not been set to display meta characters directly, this will convert meta characters to a meta-prefixed key sequence. This is intended for use by applications which wish to do their own redisplay.

Function: int rl_message (const char *, ...)

The arguments are a format string as would be supplied to printf, possibly containing conversion specifications such as `%d', and any additional arguments necessary to satisfy the conversion specifications. The resulting string is displayed in the echo area. The echo area is also used to display numeric arguments and search strings.

Function: int rl_clear_message (void)

Clear the message in the echo area.

Function: void rl_save_prompt (void)

Save the local Readline prompt display state in preparation for displaying a new message in the message area with rl_message().

Function: void rl_restore_prompt (void)

Restore the local Readline prompt display state saved by the most recent call to rl_save_prompt.

Function: int rl_expand_prompt (char *prompt)

Expand any special character sequences in prompt and set up the local Readline prompt redisplay variables. This function is called by readline(). It may also be called to expand the primary prompt if the rl_on_new_line_with_prompt() function or rl_already_prompted variable is used. It returns the number of visible characters on the last line of the (possibly multi-line) prompt.

Function: int rl_set_prompt (const char *prompt)

Make Readline use prompt for subsequent redisplay. This calls rl_expand_prompt() to expand the prompt and sets rl_prompt to the result.