bionic (3) reverse.3.gz

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).