Coin Logo http://www.sim.no
http://www.coin3d.org

Main Page | Modules | Class Hierarchy | Alphabetical List | Class List | Directories | File List | Class Members | Related Pages

SoBaseList Class Reference
[General classes]

#include <Inventor/lists/SoBaseList.h>

Inheritance diagram for SoBaseList:

SbPList SoEngineList SoNodeList SoPathList SoChildList List of all members.

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.


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)
SoBaseListoperator= (const SoBaseList &l)
SoBaseoperator[] (const int i) const
void set (const int i, SoBase *const ptr)
void addReferences (const SbBool flag)
SbBool isReferencing (void) const


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).

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).

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).

See also:
SbPList::remove()

Reimplemented from SbPList.

Reimplemented in SoChildList.

void SoBaseList::removeItem SoBase item  ) 
 

Removes item from the list, dereferencing the object (unless addReferences() has been set to FALSE).

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).

See also:
SbPList::truncate()

Reimplemented in SoChildList.

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 idx.

Will automatically expand the size of the internal array if idx is outside the current bounds of the list. The values of any additional pointers are then set to NULL.

Reimplemented from SbPList.

Reimplemented in SoEngineList, SoNodeList, and SoPathList.

void SoBaseList::set const int  i,
SoBase *const   ptr
 

Index operator to set element at i. Does not expand array bounds if i is outside the list.

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


The documentation for this class was generated from the following files:

Copyright © 1998-2005 by Systems in Motion AS. All rights reserved.

Generated on Wed May 31 00:48:44 2006 for Coin by Doxygen. 1.4.4