GNU Info

(readline.info)Redisplay

---

Next: Modifying Text Prev: Allowing Undoing Up: Readline Convenience Functions

---

Enter node , (file) or (file)node

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.