SoDetailList(3)

💖 SoDetailList(3) 💖

bestie. bestie bestie bestie. okay so today we're doing the SoDetailList page from the Coin manual (that's section 3, the library-calls girlies, iykyk), and honestly? it ate. it's a list. it holds details. it deletes them for you. main character behaviour fr fr. 🎀

---

✨ NAME ✨

SoDetailList — the class that's literally just a container for pointers to SoDetail objects. that's it. that's the whole vibe. 🦋

---

🌸 SYNOPSIS 🌸

#include <Inventor/lists/SoDetailList.h>

Inherits SbPList. so it's giving nepo baby but in the good way, she got all the family traits 💅

👑 Public Member Functions

SoDetailList (void)
SoDetailList (const int sizehint)
SoDetailList (const SoDetailList &l)
~SoDetailList ()
void append (SoDetail *detail)
void insert (SoDetail *detail, const int insertbefore)
void truncate (const int length, const int fit=0)
void copy (const SoDetailList &l)
SoDetailList & operator= (const SoDetailList &l)
SoDetail * operator[] (const int idx) const
void set (const int index, SoDetail *item)

🧚 Public Member Functions inherited from SbPList

look at her inheritance, she's stacked ✨

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 (const 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)

🫶 Additional Inherited Members

🍓 Protected Member Functions inherited from SbPList

void expand (const int size)
int getArraySize (void) const

---

🌈 DETAILED DESCRIPTION 🌈

The SoDetailList class is a container for pointers to SoDetail objects. queen of holding things. 👜

so here's the important part, listen up because this is the plot twist: this list class will delete the details when destructed/truncated, or when a detail in the list is replaced by another detail. she cleans up after herself, no cap.

and the caller (that's you, bestie 🫵) is responsible for allocating the details passed to the list, but should not deallocate them, since this will be handled by the list. so you make the baby, she raises it. don't you dare try to delete it yourself, that's giving double-free and we do not do that here 💀

See also: SbPList

---

🎀 Constructor & Destructor Documentation 🎀

SoDetailList::SoDetailList (void ) [inline]

Default constructor. the standard girl. shows up, does her job, no notes. ⭐

SoDetailList::SoDetailList (const int sizehint) [inline]

This constructor initializes the internal allocated size for the list to sizehint. note: the list will still initially contain zero items. so like, she reserved the table but nobody's sitting at it yet 🙈

See also: SbList::SbList(const int sizehint)

SoDetailList::SoDetailList (const SoDetailList & l)

Copy constructor. twin energy. 👯

SoDetailList::~SoDetailList ()

Destructor. she's leaving and she's taking the details with her (and deleting them, as established). bye bestie 💜

---

💅 Member Function Documentation 💅

void SoDetailList::append (SoDetail * item) [inline]

Append item to the end of the list. line up, girl, you're at the back now.

Automatically allocates more items internally if needed. she grows. that's growth. 🌱

Overloaded from parent to accept an SoDetail pointer argument.

See also: SbPList::append()

void SoDetailList::insert (SoDetail * item, const int insertbefore) [inline]

Insert item at index insertbefore. she's cutting the line, but legally.

insertbefore should not be larger than the current number of items in the list. fr fr, don't try it.

Overloaded from parent to accept an SoDetail pointer argument.

See also: SbPList::insert()

void SoDetailList::truncate (const int length, const int fit = 0)

Shorten the list to contain length elements, removing items from index length and onwards. so everything past that line? gone. deleted. not even a goodbye text. 😭

If fit is non-zero, will also shrink the internal size of the allocated array. heads up: this is much less efficient than not re-fitting the array size. so like, you can do it, but it's giving extra for no reason.

Overloaded from parent to delete truncated items.

See also: SbPList::truncate()

void SoDetailList::copy (const SoDetailList & l)

Make this list a copy of l.

Overloaded from parent to copy items, not just pointers. this is the difference, bestie, she does a deep copy of the things, not the vibes of the things ✨

See also: SbPList::copy()

SoDetailList & SoDetailList::operator= (const SoDetailList & l) [inline]

Make this list a copy of l. same as above but with the assignment swagger. 💅

SoDetail * SoDetailList::operator[] (const int idx) 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. yes she just makes room and fills it with nothing. iconic.

Overloaded from parent to return an SoDetail pointer.

See also: SbPList::operator[]()

void SoDetailList::set (const int idx, SoDetail * detail)

Index operator to set element at index. Does not expand array bounds if index is outside the list. so no magic growth here, she stays the same size, periodt.

Overloaded from parent to destruct the replaced item. (yes, the old one gets deleted, we covered this 💀)

See also: SbPList::set()

---

🌟 Author 🌟

Generated automatically by Doxygen for Coin from the source code. so technically the author is a robot and technically that robot is serving 💖

---

that's the whole page bestie, go forth and list your details responsibly. mwah 🫶💖✨

Version 4.0.10 — Thu Jun 25 2026 00:00:00 🎀