reverse.3alc man page

reverse
reverse

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

Referenced By

unflattenlofig.3alc(3).

October 1, 1997 ASIM/LIP6 MBK UTILITY FUNCTIONS