Main Page Modules Class Hierarchy Alphabetical List Compound List File List Compound Members
SbList Class Reference
The SbList class is a template container class for lists.
More...
#include <Inventor/lists/SbList.h>
List of all members.
Detailed Description
The SbList class is a template container class for lists.
SbList is an extension of the Coin library versus the original Open Inventor API. Open Inventor handles most list classes by inheriting the SbPList class, which contains an array of generic void*
pointers. By using this template-based class instead, we can share more code and make the list handling code more typesafe.
Care has been taken to make sure the list classes which are part of the Open Inventor API to still be compatible with their original interfaces, as derived from the SbPList base class. But if you still bump into any problems when porting your Open Inventor applications, let us know and we'll do our best to sort them out.
A feature with this class is that the list object arrays grow dynamically as you append() more items to the list. The actual growing technique used is to double the list size when it becomes too small.
There are also other array-related convenience methods; e.g. finding item indices, inserting items at any position, removing items (and shrink the array), copying of arrays, etc.
-
See also:
-
SbPList
Constructor & Destructor Documentation
SbList::SbList
|
(  |
const int |
sizehint = DEFAULTSIZE |
) |
[inline] |
|
|
Default constructor.
The sizehint argument hints about how many elements the list will contain, so memory allocation can be done efficiently.
Important note: explicitly specifying an sizehint value does not mean that the list will initially contain this number of values. After construction, the list will contain zero items, just as for the default constructor. Here's a good example on how to give yourself hard to find bugs:
Since this conceptual misunderstanding is so easy to make, you're probably better (or at least safer) off leaving the sizehint argument to its default value by not explicitly specifying it.
It improves performance if you know the approximate total size of the list in advance before adding list elements, as the number of reallocations will be minimized. |
SbList::SbList
|
(  |
const SbList< Type > & |
l |
) |
[inline] |
|
|
Copy constructor. Creates a complete copy of the given list. |
SbList::~SbList
|
(  |
|
) |
[inline] |
|
|
Destructor, frees all internal resources used by the list container. |
Member Function Documentation
void SbList::copy
|
(  |
const SbList< Type > & |
l |
) |
[inline] |
|
|
Make this list a copy of l. |
SbList< Type > & SbList::operator=
|
(  |
const SbList< Type > & |
l |
) |
[inline] |
|
|
Make this list a copy of l. |
void SbList::fit
|
(  |
void |
|
) |
[inline] |
|
|
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. |
void SbList::append
|
(  |
const Type |
item |
) |
[inline] |
|
|
Append the item at the end of list, expanding the list array by one. |
int SbList::find
|
(  |
const Type |
item |
) |
const [inline] |
|
|
Return index of first occurrence of item in the list, or -1 if item is not present. |
void SbList::insert
|
(  |
const Type |
item, |
|
|
|
|
|
const int |
insertbefore |
|
)  |
[inline] |
|
|
Insert item at index insertbefore.
insertbefore should not be larger than the current number of items in the list. |
void SbList::removeItem
|
(  |
const Type |
item |
) |
[inline] |
|
|
Removes an item from the list. If there are several items with the same value, removes the item with the lowest index. |
void SbList::remove
|
(  |
const int |
index |
) |
[inline] |
|
|
Remove the item at index, moving all subsequent items downwards on place in the list. |
void SbList::removeFast
|
(  |
const int |
index |
) |
[inline] |
|
|
Remove the item at index, moving the last item into its place and truncating the list. |
int SbList::getLength
|
(  |
void |
|
) |
const [inline] |
|
|
Returns number of items in the list. |
void SbList::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. |
void SbList::push
|
(  |
const Type |
item |
) |
[inline] |
|
|
This appends item at the end of the list in the same fashion as append() does. Provided as an abstraction for using the list class as a stack. |
Type SbList::pop
|
(  |
void |
|
) |
[inline] |
|
|
Pops off the last element of the list and returns it. |
const Type * SbList::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. |
Type SbList::operator[]
|
(  |
const int |
index |
) |
const [inline] |
|
|
Returns a copy of item at index. |
Type & SbList::operator[]
|
(  |
const int |
index |
) |
[inline] |
|
|
Returns a reference to item at index. |
SbBool SbList::operator==
|
(  |
const SbList< Type > & |
l |
) |
const [inline] |
|
|
Equality operator. Returns TRUE if this list and l are identical, containing the exact same set of elements. |
SbBool SbList::operator!=
|
(  |
const SbList< Type > & |
l |
) |
const [inline] |
|
|
Inequality operator. Returns TRUE if this list and l are not equal. |
void SbList::expand
|
(  |
const int |
size |
) |
[inline, protected] |
|
|
Expand the list to contain size items. The new items added at the end have undefined value. |
int SbList::getArraySize
|
(  |
void |
|
) |
const [inline, protected] |
|
|
Return number of items there's allocated space for in the array.
-
See also:
-
getLength()
|
The documentation for this class was generated from the following files:
Generated at Tue Mar 5 03:31:26 2002 for Coin by
1.2.9 written by Dimitri van Heesch,
© 1997-2001