(readline.info.gz) Redisplay

Info Catalog

(readline.info.gz) Allowing Undoing

(readline.info.gz) Readline Convenience Functions

(readline.info.gz) Modifying Text

 
 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.  You should call `rl_save_prompt' to save the
      prompt information before calling this function.
 
  -- Function: int rl_clear_message (void)
      Clear the message in the echo area.  If the prompt was saved with
      a call to `rl_save_prompt' before the last call to `rl_message',
      call `rl_restore_prompt' before calling this function.
 
  -- 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'.  if `rl_save_prompt' was called
      to save the prompt before a call to `rl_message', this function
      should be called before the corresponding call to
      `rl_clear_message'.
 
  -- 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.  Applications may indicate that the prompt contains
      characters that take up no physical screen space when displayed by
      bracketing a sequence of such characters with the special markers
      `RL_PROMPT_START_IGNORE' and `RL_PROMPT_END_IGNORE' (declared in
      `readline.h'.  This may be used to embed terminal-specific escape
      sequences in prompts.
 
  -- 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.
 

Info Catalog

(readline.info.gz) Allowing Undoing

(readline.info.gz) Readline Convenience Functions

(readline.info.gz) Modifying Text