SoFieldList(3)

🎀 SoFieldList 🎀

okay bestie, gather round 💖 this is a Coin manual page from section 3, and it's about SoFieldList — literally just a container for pointers to SoField objects. that's the whole vibe. it's giving "glorified array but make it C++". let's get into it 🦋

---

✨ NAME ✨

SoFieldList — the SoFieldList class is a container for pointers to SoField objects. periodt 💅

---

🌸 SYNOPSIS 🌸

#include <Inventor/lists/SoFieldList.h>

Inherits SbPList. yes queen, she's a subclass, she's got family 👑

💖 Public Member Functions

SoFieldList (void)
SoFieldList (const int sizehint)
SoFieldList (const SoFieldList &l)
void append (SoField *field)
void insert (SoField *field, const int insertbefore)
SoField * operator[] (const int idx) const
void set (const int idx, SoField *field)
SoField * get (const int idx) const

🌈 Public Member Functions inherited from SbPList

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 SoFieldList class is a container for pointers to SoField objects.

no cap, that's it. she holds your SoField pointers. she's not complicated, she's not doing too much, she's just there for you 🥰

See also

• SbList

---

🎀 CONSTRUCTOR & DESTRUCTOR DOCUMENTATION 🎀

🌟 SoFieldList::SoFieldList (void ) [inline]

Default constructor. the blank slate. the fresh start. main character energy ✨

🌟 SoFieldList::SoFieldList (const int sizehint) [inline]

This constructor initializes the internal allocated size for the list to sizehint. Note that the list will still initially contain zero items.

fr fr: sizehint is just a heads-up about how much room to reserve internally — it does not mean the list starts out with that many things in it. she's pre-gaming, not already partying 💀

See also

• SbList::SbList(const int)

🌟 SoFieldList::SoFieldList (const SoFieldList & l) [inline]

Copy constructor. twin telepathy, but for lists 👯‍♀️

See also

• SbList::SbList(const SbList<Type> & l)

---

💅 MEMBER FUNCTION DOCUMENTATION 💅

🦋 void SoFieldList::append (SoField * field) [inline]

Append item to the end of the list. she goes at the back, no cutting the line 🚫

Automatically allocates more items internally if needed. yes bestie, she grows on demand, she's ✨adaptable✨

Overloaded from parent to accept an SoField pointer argument.

See also

• SbPList::append()

🦋 void SoFieldList::insert (SoField * field, const int insertbefore) [inline]

Insert item at index insertbefore.

insertbefore should not be larger than the current number of items in the list.

⚠️ okay so like, respect the bounds. if insertbefore is bigger than the number of items you've actually got, that's on you and it is not the vibe.

Overloaded from parent to accept an SoField pointer argument.

See also

• SbPList::insert()

🦋 SoField * SoFieldList::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.

😭 not her just making room for you and filling the new spots with NULL. that's generous. that's growth mindset. that's iconic.

Overloaded from parent to return an SoField pointer.

See also

• SbPList::operator[]()

🦋 void SoFieldList::set (const int index, SoField * item) [inline]

Overloaded from parent to accept an SoField pointer argument.

🦋 SoField * SoFieldList::get (const int idx) const [inline]

Returns element at index. Does not expand array bounds if index is outside the list.

🙈 note the difference from operator[]: this one will not stretch the array for you. no free growth here. she's just looking, not building.

Overloaded from parent to return an SoField pointer.

See also

• SbPList::get()

---

👑 AUTHOR 👑

Generated automatically by Doxygen for Coin from the source code. yeah, a robot wrote the skeleton of this, but the attitude? that's all me 💖

---

okay that's the whole page bestie, you're officially fluent in SoFieldList 🌈 this was Version 4.0.10, dated Thu Jun 25 2026 00:00:00, and it belongs to the SoFieldList(3) manual page in the Coin docs. go forth and store pointers responsibly 🫶💅✨