Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
REVERSE(3)		      MBK UTILITY FUNCTIONS		      REVERSE(3)

NAME
     reverse - reverse a list of chained elements

SYNOPSIS
     #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 ap-
	    propriate  cast,  one  can	reverse  any mbk list. Let's notice that
	    nothing in the C language description demands a structure to be  de-
	    fined  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).

ASIM/LIP6			 October 1, 1997		      REVERSE(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=reverse&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help