![]() |
http://www.sim.no http://www.coin3d.org |
#include <Inventor/lists/SbPList.h>
Public Member Functions | |
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 (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) |
Protected Member Functions | |
void | expand (const int size) |
int | getArraySize (void) const |
SbPList::SbPList | ( | const int | sizehint = DEFAULTSIZE |
) |
This constructor initializes the internal allocated size for the list to sizehint. Note that the list will still initially contain zero items.
Default constructor.
SbPList::~SbPList | ( | ) |
Destructor.
void SbPList::copy | ( | const SbPList & | l | ) |
Make this list a copy of l.
References expand(), itembuffer, and numitems.
Referenced by operator=(), SbPList(), and SoPickedPointList::SoPickedPointList().
void SbPList::fit | ( | void | ) |
Fit the allocated array exactly around the length of the list, descarding memory spent on unused pre-allocated array cells.
You should normally not need or want to call this method, and it is only available for the sake of having the option to optimize memory usage for the unlikely event that you should throw around huge SbList objects within your application.
Referenced by truncate().
void SbPList::append | ( | void * | item | ) | [inline] |
Append item to the end of the list.
Automatically allocates more items internally if needed.
Referenced by SoCallbackList::addCallback(), SoBase::addName(), SoFieldList::append(), SoOffscreenRenderer::getWriteFiletypeInfo(), and SoAuditorList::notify().
int SbPList::find | ( | void * | item | ) | const |
Return index of first occurrence of item in the list, or -1 if item is not present.
Referenced by SoEngineOutput::addConnection(), SoPath::append(), SoBaseKit::createPathToAnyPart(), SoDB::createRoute(), SbStringList::find(), SoGroup::findChild(), SoAuditorList::notify(), SoEngineOutput::removeConnection(), SoBaseList::removeItem(), removeItem(), SoBase::removeName(), SoBaseKit::setPart(), and SoChildList::traverse().
void SbPList::insert | ( | void * | item, | |
const int | insertbefore | |||
) |
Insert item at index insertbefore.
insertbefore should not be larger than the current number of items in the list.
Referenced by SoFieldList::insert(), and SbStringList::insert().
void SbPList::removeItem | ( | void * | item | ) |
Removes an item from the list. If there are several items with the same value, removes the item with the lowest index.
References find().
void SbPList::remove | ( | const int | index | ) |
Remove the item at index, moving all subsequent items downwards one place in the list.
Reimplemented in SoAuditorList, SoBaseList, and SoChildList.
Referenced by SoInput::clearDirectories(), SoCallbackList::removeCallback(), SoEngineOutput::removeConnection(), SoInput::removeDirectory(), and SoBase::removeName().
void SbPList::removeFast | ( | const int | index | ) | [inline] |
Remove the item at index, moving the last item into its place and truncating the list.
int SbPList::getLength | ( | void | ) | const [inline] |
Returns number of items in the list.
Reimplemented in SoAuditorList.
Referenced by SoNodeKitListPart::addChildType(), SoBaseList::addReferences(), SoNode::addToCopyDict(), SoPath::append(), SoReorganizeAction::apply(), SoLineHighlightRenderAction::apply(), SoBoxHighlightRenderAction::apply(), SoAction::apply(), SoText3::computeBBox(), SoDetailList::copy(), SoChildList::copy(), SoBaseList::copy(), SoWWWInline::copyChildren(), SoFile::copyChildren(), SoWWWInline::copyContents(), SoFile::copyContents(), SoElement::createStackIndex(), SoEngineOutput::doneWriting(), SbString::findAll(), SbBSPTree::findClosest(), SoInput::findFile(), SoPathList::findPath(), SoWWWInline::getBoundingBox(), SoTransformManip::getBoundingBox(), SoSpotLightManip::getBoundingBox(), SoPointLightManip::getBoundingBox(), SoNodeKitListPart::getBoundingBox(), SoFile::getBoundingBox(), SoDirectionalLightManip::getBoundingBox(), SoClipPlaneManip::getBoundingBox(), SoBaseKit::getBoundingBox(), SoVRMLInline::getBoundingBox(), SoNodeKitListPart::getChildTypes(), SoField::getConnections(), SoTransformManip::getDragger(), SoSpotLightManip::getDragger(), SoPointLightManip::getDragger(), SoDirectionalLightManip::getDragger(), SoClipPlaneManip::getDragger(), SoFieldConverter::getForwardConnections(), SoEngineOutput::getForwardConnections(), SoPath::getLength(), SoBase::getNamedBase(), SoBase::getNamedBases(), SoCallbackList::getNumCallbacks(), SoGroup::getNumChildren(), SoEngineOutput::getNumConnections(), SoSelection::getNumSelected(), SoElement::getNumStackIndices(), SoPath::getTail(), SoGroup::GLRender(), SoVRMLShape::GLRender(), SoVRMLCollision::GLRender(), SoVRMLAppearance::GLRender(), SoSeparator::GLRenderBelowPath(), SoVRMLGroup::GLRenderBelowPath(), SoVRMLBillboard::GLRenderBelowPath(), SoChildList::insert(), SoCallbackList::invokeCallbacks(), SoInteractionKit::isPathSurrogateInMySubgraph(), SoNodeKitListPart::isTypePermitted(), SoWWWInline::isURLDataHere(), operator[](), SoEngineOutput::prepareToWrite(), SoBaseKit::printTable(), SoAction::pushCurPath(), SoBaseKit::rayPick(), SoInteractionKit::readInstance(), SoField::referencesCopy(), SoChildList::remove(), SoBaseList::remove(), SoInput::removeDirectory(), SoInput::searchForFile(), SbImage::searchForFile(), SoPickedPointList::set(), SoDetailList::set(), SoChildList::set(), SoNodeKitListPart::setContainerType(), SoInput::setDirectories(), SoTransformManip::setDragger(), SoSpotLightManip::setDragger(), SoPointLightManip::setDragger(), SoDirectionalLightManip::setDragger(), SoActionMethodList::setUp(), SoShape::shouldGLRender(), SoBaseList::SoBaseList(), SoPickedPoint::SoPickedPoint(), SoPickedPointList::SoPickedPointList(), SoPathList::sort(), SoState::SoState(), SoToVRML2Action::SoToVRML2Action(), SoChildList::traverse(), SoPickedPointList::truncate(), SoDetailList::truncate(), SoChildList::truncate(), SoBaseList::truncate(), SoPathList::uniquify(), SoVRMLParent::updateChildList(), SoAction::usePathCode(), and SbVec3fList::~SbVec3fList().
void SbPList::truncate | ( | const int | length, | |
const int | fit = 0 | |||
) | [inline] |
Shorten the list to contain length elements, removing items from index length and onwards.
If fit is non-zero, will also shrink the internal size of the allocated array. Note that this is much less efficient than not re-fitting the array size.
Reimplemented in SoDetailList, and SoPickedPointList.
References fit().
Referenced by SoCallbackList::clearCallbacks(), SbString::findAll(), SoOffscreenRenderer::getWriteFiletypeInfo(), and SoActionMethodList::setUp().
void ** SbPList::getArrayPtr | ( | const int | start = 0 |
) | const [inline] |
Returns pointer to a non-modifiable array of the lists elements. start specifies an index into the array.
The caller is not responsible for freeing up the array, as it is just a pointer into the internal array used by the list.
Referenced by SoPath::findNode(), SbStringList::getArrayPtr(), SoGroup::getChild(), SoGroup::GLRender(), SoVRMLShape::GLRender(), SoVRMLCollision::GLRender(), SoVRMLAppearance::GLRender(), SoSeparator::GLRenderBelowPath(), SoVRMLGroup::GLRenderBelowPath(), SoVRMLBillboard::GLRenderBelowPath(), SoSeparator::GLRenderInPath(), SoVRMLGroup::GLRenderInPath(), SoVRMLBillboard::GLRenderInPath(), SoPathList::sort(), SoPathList::uniquify(), and SoVRMLParent::updateChildList().
void *& SbPList::operator[] | ( | const int | index | ) | const [inline] |
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
.
Reimplemented in SbIntList, SbStringList, SbVec3fList, SoBaseList, SoDetailList, SoEngineList, SoEngineOutputList, SoFieldList, SoNodeList, SoPathList, SoPickedPointList, and SoTypeList.
References getLength().
Referenced by SoAuditorList::getObject(), SoPickedPointList::operator[](), SoFieldList::operator[](), SoEngineOutputList::operator[](), and SoFieldList::set().
int SbPList::operator== | ( | const SbPList & | l | ) | const |
Equality operator. Returns TRUE
if this list and l are identical, containing the exact same set of elements.
References itembuffer, and numitems.
SbBool SbPList::operator!= | ( | const SbPList & | l | ) | const [inline] |
Inequality operator. Returns TRUE
if this list and l are not equal.
void * SbPList::get | ( | const int | index | ) | const [inline] |
Returns element at index. Does not expand array bounds if index is outside the list.
Reimplemented in SoFieldList.
Referenced by SoFieldList::get(), SoLOD::GLRenderBelowPath(), and SoVRMLLOD::GLRenderBelowPath().
void SbPList::set | ( | const int | index, | |
void * | item | |||
) | [inline] |
Index operator to set element at index. Does not expand array bounds if index is outside the list.
void SbPList::expand | ( | const int | size | ) | [inline, protected] |
Expand the list to contain size items. The new items added at the end have undefined value.
Referenced by copy().
int SbPList::getArraySize | ( | void | ) | const [inline, protected] |
Copyright © 1998-2007 by Systems in Motion AS. All rights reserved.
Generated on Mon Feb 23 16:33:41 2009 for Coin by Doxygen. 1.5.8