SoBaseList(3IV)

NAME
     SoBaseList (SoBaseList) - maintains a list of pointers to instances of
     the SoBase classes

INHERITS FROM
     SbPList > SoBaseList

SYNOPSIS
     #include <Inventor_c/SoLists.h>

          Functions from class SoBaseList:

     SoBaseList *        SoBaseListCreate()
     SoBaseList *        SoBaseListCreateSize(int size)
     void                SoBaseListDelete(SoBaseList *this)
     void                SoBaseListAppend(SoBaseList *this, SoBase *ptr)
     void                SoBaseListInsert(SoBaseList *this, SoBase *ptr, int
                              addBefore)
     void                SoBaseListRemove(SoBaseList *this, int which)
     void                SoBaseListTruncate(SoBaseList *this, int start)
     void                SoBaseListCopy(SoBaseList *this, const SoBaseList *l)
     SoBase *            SoBaseListUnknownOperator(const SoBaseList *this, int
                              i)
     void                SoBaseListSet(SoBaseList *this, int i, SoBase *ptr)
     void                SoBaseListAddReferences(SoBaseList *this, SbBool
                              flag)

          Functions from class SbPList:

     int                 SoBaseListFind(const SoBaseList *this, const void
                              *ptr)
     int                 SoBaseListGetLen(const SoBaseList *this)
     int                 SoBaseListIsEq(const SoBaseList *this, const SbPList
                              *pl)
     int                 SoBaseListIsNEq(const SoBaseList *this, const SbPList
                              *pl)


DESCRIPTION
     This subclass of SbPList holds lists of pointers to instances of classes
     derived from SoBase (an abstract class). A flag indicates whether adding
     an instance pointer to the list should add a reference to the instance.
     If this flag is TRUE, then adding and removing pointers from the list
     updates reference counts in the corresponding instances.

FUNCTIONS
     SoBaseList *        SoBaseListCreate()
          Constructor.

     SoBaseList *        SoBaseListCreateSize(int size)
          Constructor that pre-allocates storage for size pointers.
     void                SoBaseListDelete(SoBaseList *this)
          Destructor.

     void                SoBaseListAppend(SoBaseList *this, SoBase *ptr)
          Adds a pointer to the end of the list.

     void                SoBaseListInsert(SoBaseList *this, SoBase *ptr, int
                              addBefore)
          Inserts given pointer in list before pointer with given index.

     void                SoBaseListRemove(SoBaseList *this, int which)
          Removes pointer with given index.

     void                SoBaseListTruncate(SoBaseList *this, int start)
          Removes all pointers after one with given index, inclusive.

     void                SoBaseListCopy(SoBaseList *this, const SoBaseList *l)
          Copies a list, keeping all reference counts correct.

     SoBase *            SoBaseListUnknownOperator(const SoBaseList *this, int
                              i)
          Accesses an element of a list.

     void                SoBaseListSet(SoBaseList *this, int i, SoBase *ptr)
          Sets an element of a list.

     void                SoBaseListAddReferences(SoBaseList *this, SbBool
                              flag)
          Indicates whether to call ref() and unref() for bases in the list
          when adding/removing them. The default value is TRUE.


SEE ALSO
     SoBase, SoNodeList, SoPathList