SoPathList(3)

💖 SoPathList — a Coin joint, bestie 💖

okay so we're doing SoPathList(3) today and honestly? she's giving container core. this is the Coin library's little holder for pointers to SoPath objects and she is SO organized. let's get into it 🦋

---

✨ NAME ✨

SoPathList — the class that's literally just a container for pointers to SoPath objects. that's the whole vibe. no notes. 💅

---

🌸 SYNOPSIS 🌸

#include <Inventor/lists/SoPathList.h>

Inherits SoBaseList. so yes, she's got a whole family tree and we're meeting the whole family, sorry not sorry 🙈

🎀 Public Member Functions 🎀

• SoPathList(void)
• SoPathList(const int size)
• SoPathList(const SoPathList &pl)
• ~SoPathList()
• void append(SoPath *const path)
• SoPath * operator[](const int i) const
• SoPathList & operator=(const SoPathList &pl)
• int findPath(const SoPath &path) const
• void sort(void)
• void uniquify(void)

💜 Public Member Functions inherited from SoBaseList 💜

• SoBaseList(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

🌈 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 🧚

ok so the SoPathList class is a container for pointers to SoPath objects. literally that's her whole job and she does it flawlessly, we stan 👑

and because she inherits from SoBaseList, the referencing and dereferencing is by default handled on the objects at append(), remove(), insert() etc. so you don't gotta babysit that yourself. no cap. 🫶

---

🎀 Constructor & Destructor Documentation 🎀

SoPathList::SoPathList(void)

Default constructor. the classic. she just shows up 💅

SoPathList::SoPathList(const int size)

Constructor with a hint about the number of elements the list will hold. it's a hint, not a promise, bestie — she's just getting ready ✨

See also: SoBaseList::SoBaseList(const int)

SoPathList::SoPathList(const SoPathList &pl)

Copy constructor 🦋

Does a shallow copy of the SoPath pointer values, but updates the reference count. so like, same pointers, but the ref count gets its little update. important detail, don't skip it 💖

See also: SoBaseList::SoBaseList(const SoBaseList &)

SoPathList::~SoPathList()

Destructor. she's leaving, say bye 😭

See also: SoBaseList::~SoBaseList()

---

💜 Member Function Documentation 💜

void SoPathList::append(SoPath *const path)

Append ptr to the list. adding to the end, putting her at the back of the line, iconic behavior ✨

See also: SoBaseList::append()

SoPath * SoPathList::operator[](const int i) const

Return node pointer at index i. that's it, that's the function 🌸

See also: SoBaseList::operator[]()

SoPathList & SoPathList::operator=(const SoPathList &pl)

Shallow copy of contents of list pl to this list. giving copy-paste energy but make it shallow 💅

See also: SoBaseList::operator=()

int SoPathList::findPath(const SoPath &path) const

Find and return the index of the first item equal to path. first match only, she's not doing a whole scavenger hunt 🔍

void SoPathList::sort(void)

Sort paths in the list according to how early they are run into when traversing the scene graph. so like, whichever one you bump into first in the traversal wins the front seat 👑

void SoPathList::uniquify(void)

Removes identical paths and paths that go through the tail of another path. cleaning house, we love a declutter era 🧹

Note that this method assumes the list to be in a sorted order. so like, if you didn't sort() first, that's on you bestie, she said what she said 😭

See also: sort()

---

🌟 Author 🌟

Generated automatically by Doxygen for Coin from the source code. so technically a robot wrote this but I'm the one translating it into feelings 💖

---

and that's the whole page, periodt 🎀 this was SoPathList(3) from the Coin manual, Version 4.0.10, dated Thu Jun 25 2026 00:00:00 — mwah, go build something cute 🦋✨