CEL_NEXTPTR

Gets the pointer to the next cel in a list.

Synopsis

CCB * CEL_NEXTPTR(ccb)

Description

This macro evaluates to a pointer to the next cel. It takes the CCB_NPABS flag into account and always returns an absolute pointer, even when the CCB contains a relative offset in the ccb_NextPtr field. Evaluates to NULL if the CCB_LAST flag is set, or if the ccb_NextPtr field is NULL or zero.

This macro evaluates its argument more than once; be careful of side effects. It is usable in expression context.

Arguments

ccb
Pointer to a cel.

Return Value

Pointer to the next cel, a CCB* type. NULL if there is no next cel.

Implementation

Macro

Associated Files

lib3do.lib, celutils.h