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