2.3.4 Moving Around the History List

These functions allow the current index into the history list to be set or changed.

Function: int history_set_pos (int pos)

Set the current history offset to pos, an absolute index into the list. Returns 1 on success, 0 if pos is less than zero or greater than the number of history entries.

Function: HIST_ENTRY * previous_history (void)

Back up the current history offset to the previous history entry, and return a pointer to that entry. If there is no previous entry, return a NULL pointer.

Function: HIST_ENTRY * next_history (void)

Move the current history offset forward to the next history entry, and return the a pointer to that entry. If there is no next entry, return a NULL pointer.