DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

(history.info.gz) Searching the History List

Info Catalog (history.info.gz) Moving Around the History List (history.info.gz) History Functions (history.info.gz) Managing the History File
 
 2.3.5 Searching the History List
 --------------------------------
 
 These functions allow searching of the history list for entries
 containing a specific string.  Searching may be performed both forward
 and backward from the current history position.  The search may be
 "anchored", meaning that the string must match at the beginning of the
 history entry.  
 
  -- Function: int history_search (const char *string, int direction)
      Search the history for STRING, starting at the current history
      offset.  If DIRECTION is less than 0, then the search is through
      previous entries, otherwise through subsequent entries.  If STRING
      is found, then the current history index is set to that history
      entry, and the value returned is the offset in the line of the
      entry where STRING was found.  Otherwise, nothing is changed, and
      a -1 is returned.
 
  -- Function: int history_search_prefix (const char *string, int
           direction)
      Search the history for STRING, starting at the current history
      offset.  The search is anchored: matching lines must begin with
      STRING.  If DIRECTION is less than 0, then the search is through
      previous entries, otherwise through subsequent entries.  If STRING
      is found, then the current history index is set to that entry, and
      the return value is 0.  Otherwise, nothing is changed, and a -1 is
      returned.
 
  -- Function: int history_search_pos (const char *string, int
           direction, int pos)
      Search for STRING in the history list, starting at POS, an
      absolute index into the list.  If DIRECTION is negative, the search
      proceeds backward from POS, otherwise forward.  Returns the
      absolute index of the history element where STRING was found, or
      -1 otherwise.
 
Info Catalog (history.info.gz) Moving Around the History List (history.info.gz) History Functions (history.info.gz) Managing the History File
automatically generated byinfo2html