Info Catalog history: History List Management history: History Functions history: Moving Around the History List

history: Information About the History List

 
 2.3.3 Information About the History List
 ----------------------------------------
 
 These functions return information about the entire history list or
 individual list entries.
 
  -- Function: HIST_ENTRY ** history_list (void)
      Return a 'NULL' terminated array of 'HIST_ENTRY *' which is the
      current input history.  Element 0 of this list is the beginning of
      time.  If there is no history, return 'NULL'.
 
  -- Function: int where_history (void)
      Returns the offset of the current history element.
 
  -- Function: HIST_ENTRY * current_history (void)
      Return the history entry at the current position, as determined by
      'where_history()'.  If there is no entry there, return a 'NULL'
      pointer.
 
  -- Function: HIST_ENTRY * history_get (int offset)
      Return the history entry at position OFFSET, starting from
      'history_base' (History Variables).  If there is no entry
      there, or if OFFSET is greater than the history length, return a
      'NULL' pointer.
 
  -- Function: time_t history_get_time (HIST_ENTRY *entry)
      Return the time stamp associated with the history entry ENTRY.  If
      the timestamp is missing or invalid, return 0.
 
  -- Function: int history_total_bytes (void)
      Return the number of bytes that the primary history entries are
      using.  This function returns the sum of the lengths of all the
      lines in the history.
 

Info Catalog history: History List Management history: History Functions history: Moving Around the History List