Home / Autodocs / intuition.library
NAME
- NextObject
-
iterate through the object on an Exec list. (V36)
SYNOPSIS
object = NextObject( objectPtrPtr )
D0 A0
APTR NextObject( APTR );
D0 A0
APTR NextObject( APTR );
FUNCTION
This function is for boopsi class implementors only.
When you collect a set of boopsi objects on an Exec List structure by invoking their OM_ADDMEMBER method, you can (only) retrieve them by iterations of this function.
Works even if you remove and dispose the returned list members in turn.
When you collect a set of boopsi objects on an Exec List structure by invoking their OM_ADDMEMBER method, you can (only) retrieve them by iterations of this function.
Works even if you remove and dispose the returned list members in turn.
INPUTS
Initially, you set a pointer variable to equal the lh_Head field of the list (or mlh_Head field of a MinList). You pass the *address* of that pointer repeatedly to NextObject() until it returns NULL.
EXAMPLE
/* here is the OM_DISPOSE case of some class's dispatcher */
case OM_DISPOSE:
case OM_DISPOSE:
/* dispose members */
object_state = mydata->md_CollectionList.lh_Head;
while ( member_object = NextObject( &object_state ) )
{
}
object_state = mydata->md_CollectionList.lh_Head;
while ( member_object = NextObject( &object_state ) )
{
DoMethod( member_object, OM_REMOVE ); /* remove from list */
DoMethodA( member, msg ); /* and pass along dispose */
DoMethodA( member, msg ); /* and pass along dispose */
RESULT
Returns pointers to each object in the list in turn, and NULL when there are no more.
SEE ALSO
DisposeObject(), SetAttrs(), GetAttr(), MakeClass(), Document "Basic Object-Oriented Programming System for Intuition" and the "boopsi Class Reference" document.