NAME
        NextObject -- iterate through the object on an Exec list. (V36)

    SYNOPSIS
        object = NextObject( objectPtrPtr )
        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.

    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:
            /* dispose members  */
            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       */
            }

    RESULT
        Returns pointers to each object in the list in turn, and NULL
        when there are no more.

    NOTES

    BUGS

    SEE ALSO
        disposeobject(), setattrs(), getattr(), makeclass(),
        Document "Basic Object-Oriented Programming System for Intuition"
        and the "boopsi Class Reference" document.