SbPList - Online Linux Manual PageSection : 3
Updated : Mon Jan 25 2021
Source : Version 2.5.0
Note : Coin

NAMESbPList − The SbPList class is a container class for void pointers​.

SYNOPSIS
#include <Inventor/lists/SbPList​.h> Inherited by SbIntList, SbStringList, SbVec3fList, SoActionMethodList, SoAuditorList [private], SoBaseList, SoDetailList, SoEngineOutputList, SoFieldList, SoPickedPointList, and SoTypeList​.

Public Member FunctionsSbPList (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 Functionsvoid expand (const int size)
int getArraySize (void) const

Detailed DescriptionThe SbPList class is a container class for void pointers​.

Constructor & Destructor Documentation

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 (const SbPList & l)Copy constructor​. References copy()​.

SbPList::~SbPList ()Destructor​.

Member Function Documentation

void SbPList::copy (const SbPList & l)Make this list a copy of l​. References expand()​. Referenced by operator=(), SbPList(), and SoPickedPointList::SoPickedPointList()​.

SbPList & SbPList::operator= (const SbPList & l)Assignment operator References copy()​.

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(), SoDetailList::truncate(), and SoPickedPointList::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(), SoTypeList::append(), SoBaseList::append(), SoFieldList::append(), SoAuditorList::append(), SoOffscreenRenderer::getWriteFiletypeInfo(), and SoAuditorList::notify()​.

int SbPList::find (void * item) constReturn 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(), SoTypeList::find(), SbStringList::find(), SoGroup::findChild(), SoPath::isRelevantNotification(), 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 SoTypeList::insert(), SbStringList::insert(), SoBaseList::insert(), and SoFieldList::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(), and remove()​.

void SbPList::remove (const int index)Remove the item at index, moving all subsequent items downwards one place in the list​. Referenced by SoInput::clearDirectories(), SoAuditorList::remove(), SoBaseList::remove(), SoCallbackList::removeCallback(), SoEngineOutput::removeConnection(), SoInput::removeDirectory(), removeItem(), 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​. Referenced by SoNodeKitListPart::addChildType(), SoBaseList::addReferences(), SoNode::addToCopyDict(), SoPath::append(), SoAction::apply(), SoBoxHighlightRenderAction::apply(), SoLineHighlightRenderAction::apply(), SoReorganizeAction::apply(), SoText3::computeBBox(), SoBaseList::copy(), SoChildList::copy(), SoDetailList::copy(), SoFile::copyChildren(), SoWWWInline::copyChildren(), SoFile::copyContents(), SoWWWInline::copyContents(), SoElement::createStackIndex(), SoEngineOutput::doneWriting(), SbString::findAll(), SbBSPTree::findClosest(), SoInput::findFile(), SoPathList::findPath(), SoClipPlaneManip::getBoundingBox(), SoDirectionalLightManip::getBoundingBox(), SoPointLightManip::getBoundingBox(), SoSpotLightManip::getBoundingBox(), SoTransformManip::getBoundingBox(), SoBaseKit::getBoundingBox(), SoNodeKitListPart::getBoundingBox(), SoFile::getBoundingBox(), SoWWWInline::getBoundingBox(), SoVRMLInline::getBoundingBox(), SoNodeKitListPart::getChildTypes(), SoField::getConnections(), SoClipPlaneManip::getDragger(), SoDirectionalLightManip::getDragger(), SoPointLightManip::getDragger(), SoSpotLightManip::getDragger(), SoTransformManip::getDragger(), SoEngineOutput::getForwardConnections(), SoFieldConverter::getForwardConnections(), SoAuditorList::getLength(), SoPath::getLength(), SoBase::getNamedBase(), SoBase::getNamedBases(), SoCallbackList::getNumCallbacks(), SoGroup::getNumChildren(), SoEngineOutput::getNumConnections(), SoSelection::getNumSelected(), SoElement::getNumStackIndices(), SoPath::getTail(), SoGroup::GLRender(), SoVRMLAppearance::GLRender(), SoVRMLCollision::GLRender(), SoVRMLShape::GLRender(), SoSeparator::GLRenderBelowPath(), SoVRMLBillboard::GLRenderBelowPath(), SoVRMLGroup::GLRenderBelowPath(), SoChildList::insert(), SoCallbackList::invokeCallbacks(), SoInteractionKit::isPathSurrogateInMySubgraph(), SoNodeKitListPart::isTypePermitted(), SoWWWInline::isURLDataHere(), operator[](), SoEngineOutput::prepareToWrite(), SoBaseKit::printTable(), SoAction::pushCurPath(), SoBaseKit::rayPick(), SoInteractionKit::readInstance(), SoField::referencesCopy(), SoBaseList::remove(), SoChildList::remove(), SoInput::removeDirectory(), SbImage::searchForFile(), SoInput::searchForFile(), SoPickedPointList::set(), SoDetailList::set(), SoChildList::set(), SoNodeKitListPart::setContainerType(), SoInput::setDirectories(), SoDirectionalLightManip::setDragger(), SoPointLightManip::setDragger(), SoSpotLightManip::setDragger(), SoTransformManip::setDragger(), SoActionMethodList::setUp(), SoShape::shouldGLRender(), SoBaseList::SoBaseList(), SoPickedPoint::SoPickedPoint(), SoPickedPointList::SoPickedPointList(), SoPathList::sort(), SoState::SoState(), SoToVRML2Action::SoToVRML2Action(), SoChildList::traverse(), SoBaseList::truncate(), SoDetailList::truncate(), SoPickedPointList::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​. References fit()​. Referenced by SoCallbackList::clearCallbacks(), SbString::findAll(), SoOffscreenRenderer::getWriteFiletypeInfo(), SoActionMethodList::setUp(), SoBaseList::truncate(), SoDetailList::truncate(), and SoPickedPointList::truncate()​.

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(), SoVRMLAppearance::GLRender(), SoVRMLCollision::GLRender(), SoVRMLShape::GLRender(), SoSeparator::GLRenderBelowPath(), SoVRMLBillboard::GLRenderBelowPath(), SoVRMLGroup::GLRenderBelowPath(), SoSeparator::GLRenderInPath(), SoVRMLBillboard::GLRenderInPath(), SoVRMLGroup::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​. References getLength()​. Referenced by SoAuditorList::getObject(), SoBaseList::operator[](), SoFieldList::operator[](), SoPickedPointList::operator[](), SoFieldList::set(), SoPickedPointList::set(), and SoDetailList::set()​.

int SbPList::operator== (const SbPList & l) constEquality operator​. Returns TRUE if this list and l are identical, containing the exact same set of elements​.

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​. 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​. Referenced by SoBaseList::set(), SoTypeList::set(), and SoAuditorList::set()​.

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]Return number of items there's allocated space for in the array​. See also getLength()

AuthorGenerated automatically by Doxygen for Coin from the source code​.
0
Johanes Gumabo
Data Size   :   45,274 byte
man-SbPList.3coin2Build   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   3 / 201,374
Visitor ID   :     :  
Visitor IP   :   3.17.183.187   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36

Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.