SoBaseList(3IV)

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

INHERITS FROM
     SbPList > SoBaseList

SYNOPSIS
     #include <Inventor/SoLists.h>

          Methods from class SoBaseList:

                         SoBaseList()
                         SoBaseList(int size)
                         SoBaseList(const SoBaseList &l)
                         ~SoBaseList()
     void                append(SoBase *ptr)
     void                insert(SoBase *ptr, int addBefore)
     void                remove(int which)
     void                truncate(int start)
     void                copy(const SoBaseList &l)
     SoBaseList &        operator =(const SoBaseList &l)
     SoBase *            operator [](int i) const
     void                set(int i, SoBase *ptr)
     void                addReferences(SbBool flag)

          Methods from class SbPList:

     int                 find(const void *ptr) const
     int                 getLength() const
     int                 operator ==(const SbPList &pl) const
     int                 operator !=(const SbPList &pl) const


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.

METHODS
                         SoBaseList()
          Constructor.

                         SoBaseList(int size)
          Constructor that pre-allocates storage for size pointers.

                         SoBaseList(const SoBaseList &l)
          Constructor that copies the contents of another list.
                         ~SoBaseList()
          Destructor.

     void                append(SoBase *ptr)
          Adds a pointer to the end of the list.

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

     void                remove(int which)
          Removes pointer with given index.

     void                truncate(int start)
          Removes all pointers after one with given index, inclusive.

     void                copy(const SoBaseList &l)
          Copies a list, keeping all reference counts correct.

     SoBaseList &        operator =(const SoBaseList &l)
          Copies a list, keeping all reference counts correct.

     SoBase *            operator [](int i) const
          Accesses an element of a list.

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

     void                addReferences(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