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

NAMESoBaseList − The SoBaseList class is a container for pointers to SoBase derived objects​.

SYNOPSIS
#include <Inventor/lists/SoBaseList​.h> Inherits SbPList​. Inherited by SoEngineList, SoNodeList, and SoPathList​.

Public Member FunctionsSoBaseList (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

Additional Inherited Members

Detailed DescriptionThe 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 &) References SbPList::getLength()​.

SoBaseList::~SoBaseList ()Destructor​. Dereferences items before freeing resources​. References truncate()​.

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() References SbPList::append(), and SoBase::ref()​. Referenced by SoEngineList::append(), SoNodeList::append(), SoPathList::append(), copy(), and SoBase::getNamedBases()​.

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() References SbPList::insert(), and SoBase::ref()​. Referenced by SoChildList::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() References SbPList::getLength(), and SbPList::remove()​. Referenced by SoChildList::remove(), removeItem(), SoSelection::removePath(), and SoPathList::uniquify()​.

void SoBaseList::removeItem (SoBase * item)Removes item from the list, dereferencing the object (unless addReferences() has been set to FALSE)​. See also SbPList::removeItem() References SbPList::find(), and remove()​.

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() References SbPList::getLength(), and SbPList::truncate()​. Referenced by SoAction::apply(), SoSearchAction::beginTraversal(), copy(), SoSearchAction::reset(), and ~SoBaseList()​.

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​. References append(), SbPList::getLength(), and truncate()​. Referenced by SoChildList::copy(), SoInteractionKit::isPathSurrogateInMySubgraph(), operator=(), SoEngineList::operator=(), SoNodeList::operator=(), and SoPathList::operator=()​.

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() References copy()​.

SoBase * SoBaseList::operator[] (const int idx) constReturns 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​. References SbPList::operator[]()​. Referenced by SoEngineList::operator[](), SoNodeList::operator[](), and SoPathList::operator[]()​.

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​. References SoBase::ref(), and SbPList::set()​. Referenced by SoBaseKit::readInstance(), and SoChildList::set()​.

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​. References SbPList::getLength(), SoBase::ref(), and SoBase::unref()​.

SbBool SoBaseList::isReferencing (void) constReturn 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

AuthorGenerated automatically by Doxygen for Coin from the source code​.
0
Johanes Gumabo
Data Size   :   33,798 byte
man-SoBaseList.3coin2Build   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   2 / 201,836
Visitor ID   :     :  
Visitor IP   :   18.191.54.190   :  
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.