Contents page

Rules for Tools/sorteventlist()

SYNOPSIS
    struct Event *sorteventlist(struct Event *list)

ARGUMENTS
    `struct Event  *list'
          Linked list of Events.

DESCRIPTION
     `sorteventlist()' sorts a list of Events in chronological order,
     returning a pointer to the top of the sorted list.  It sorts by
     the time field, the second field in the Event structure.

     You may use this routine to sort any linked list, as long as the
     list is linked by the first field in each structure and the second
     field is a four byte number (as is time) to sort by.

     `sorteventlist()' is very useful for processing linked lists of
     Events because it removes the drudgery of trying to keep
     everything in order while rearranging a list.  For example, to
     merge two linked lists, just concatonate the two lists, then send
     the result to `sorteventlist()' to put all of the Events in order.