history: Moving Around the History List
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)
If the current history offset refers to a valid history entry,
increment the current history offset. If the possibly-incremented
history offset refers to a valid history entry, return a pointer to
that entry; otherwise, return a 'BNULL' pointer.