NAME

reverse - reverse a list of chained elements

See the file buster/alliance/alc_origin.1.en.gz.

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

See the file buster/alliance/alc_bug_report.1.en.gz.