NAME

       reverse - reverse a list of chained elements

SYNOPSYS

       #include "mut.h"
       chain_list ∗reverse(ptold)
       chain_list ∗ptold;

PARAMETER

       ptold               Pointer to a chain_list to be reversed

DESCRIPTION

       The reverse function allows to reverse the order of the elements of a chain_list. It means
       that the last element becomes the first one, the one before the last one the  second  one,
       and so on.

       remark :
              all  mbk structures have for first field the NEXT field, so, with appropriate cast,
              one can reverse any  mbk  list.  Let's  notice  that  nothing  in  the  C  language
              description  demands  a  structure to be defined in memory the same way its members
              are defined in C. But all compiler do it this way now a day.  Let's  hope  it  will
              continue!

RETURN VALUE

       reverse returns a pointer to the head of the reversed list.

EXAMPLE

       #include "mut.h"
       void reverse_con(p)
       lofig_list ∗p;
       {
          p->LOCON = (locon_list ∗)reverse((chain_list ∗)p->LOCON);
       }

SEE ALSO

       mbk(1), chain(3).