SoBaseList(3) Coin SoBaseList(3) NAME SoBaseList - The SoBaseList class is a container for pointers to SoBase derived objects. SYNOPSIS #include Inherits SbPList. Inherited by SoEngineList, SoNodeList, and SoPathList. Public Member Functions SoBaseList (void) SoBaseList (const int size) SoBaseList (const SoBaseList &l) ~SoBaseList () void append (SoBase *ptr) void insert (SoBase *ptr, const int addbefore) void remove (const int index) void removeItem (SoBase *item) void truncate (const int length) void copy (const SoBaseList &l) SoBaseList & operator= (const SoBaseList &l) SoBase * operator[] (const int i) const void set (const int i, SoBase *const ptr) void addReferences (const SbBool flag) SbBool isReferencing (void) const Public Member Functions inherited from SbPList SbPList (const int sizehint=DEFAULTSIZE) SbPList (const SbPList &l) ~SbPList () void copy (const SbPList &l) SbPList & operator= (const SbPList &l) void fit (void) void append (void *item) int find (const void *item) const void insert (void *item, const int insertbefore) void removeItem (void *item) void remove (const int index) void removeFast (const int index) int getLength (void) const void truncate (const int length, const int fit=0) void ** getArrayPtr (const int start=0) const void *& operator[] (const int index) const int operator== (const SbPList &l) const int operator!= (const SbPList &l) const void * get (const int index) const void set (const int index, void *item) Additional Inherited Members Protected Member Functions inherited from SbPList void expand (const int size) int getArraySize (void) const Detailed Description The SoBaseList class is a container for pointers to SoBase derived objects. The additional capability of the SoBaseList class over its parent class, SbPList, is to automatically handle referencing and dereferencing of items as they are added or removed from the lists. Constructor & Destructor Documentation SoBaseList::SoBaseList (void) Default constructor. SoBaseList::SoBaseList (const int size) Constructor with a hint about the maximum number of pointers in the list. See also SbPList::SbPList(const int) SoBaseList::SoBaseList (const SoBaseList & l) Copy constructor. Shallow copy the items of l into this list, adding to the item reference counts if the reference flag of l is TRUE. See also SbPList::SbPList(const SbPList &) SoBaseList::~SoBaseList () Destructor. Dereferences items before freeing resources. Member Function Documentation void SoBaseList::append (SoBase * ptr) Append ptr to list, adding to the reference count of the object (unless addReferences() has been set to FALSE). Overloaded from parent to support reference counting on the SoBase object. See also SbPList::append() void SoBaseList::insert (SoBase * ptr, const int addbefore) Insert ptr in the list at position addbefore, adding to the reference count of the object (unless addReferences() has been set to FALSE). Overloaded from parent to support reference counting on the SoBase object. See also SbPList::insert() void SoBaseList::remove (const int index) Removes item at index from the list, dereferencing the object (unless addReferences() has been set to FALSE). Overloaded from parent to support reference counting on the SoBase object. See also SbPList::remove() void SoBaseList::removeItem (SoBase * item) Removes item from the list, dereferencing the object (unless addReferences() has been set to FALSE). Overloaded from parent to support reference counting on the SoBase object. See also SbPList::removeItem() void SoBaseList::truncate (const int length) Makes the list contain only the length first items, removing all items from index length and onwards to the end of the list. Dereferences the objects to be removed (unless addReferences() has been set to FALSE). Overloaded from parent to support reference counting on the SoBase object. See also SbPList::truncate() void SoBaseList::copy (const SoBaseList & l) Shallow copy of the item pointers of l list into this one, first removing all items in this list. SoBaseList & SoBaseList::operator= (const SoBaseList & l) Shallow copy of the SoBase pointers from l into this one, returning a pointer to ourself. See also copy() SoBase * SoBaseList::operator[] (const int idx) const Returns element at index. Will automatically expand the size of the internal array if index is outside the current bounds of the list. The values of any additional pointers are then set to NULL. Overloaded from parent to return an SoBase pointer. See also SbPList::operator[]() void SoBaseList::set (const int i, SoBase *const ptr) Index operator to set element at index. Does not expand array bounds if index is outside the list. Overloaded from parent to support reference counting on the SoBase object. See also SbPList::set(const int idx, void * item) void SoBaseList::addReferences (const SbBool flag) Decide whether or not the SoBase items should be automatically referenced and dereferenced as they are added and removed from the list. Default setting is to do referencing. SbBool SoBaseList::isReferencing (void) const Return whether the SoBase instances are automatically referenced and dereferenced when they are added and removed from the list. This function is an extension for Coin, and it is not available in the original SGI Open Inventor v2.1 API. See also addReferences() Since Coin 2.0 Author Generated automatically by Doxygen for Coin from the source code. Version 4.0.2 Tue Dec 26 2023 17:59:22 SoBaseList(3)