SoPathList(3IV)

NAME
     SoPathList (SoPathList) - maintains a list of pointers to paths

INHERITS FROM
     SbPList > SoBaseList > SoPathList

SYNOPSIS
     #include <Inventor_c/SoLists.h>

          Functions from class SoPathList:

     SoPathList *        SoPathListCreate()
     SoPathList *        SoPathListCreateSize(int size)
     void                SoPathListDelete(SoPathList *this)
     void                SoPathListAppend(SoPathList *this, SoPath *path)
     SoPath *            SoPathListUnknownOperator(const SoPathList *this, int
                              i)
     SoPathList *        SoPathListCopy(SoPathList *this, const SoPathList *l)
     int                 SoPathListFindPath(SoPathList *this, const SoPath
                              *path)
     void                SoPathListSort(SoPathList *this)
     void                SoPathListUniquify(SoPathList *this)

          Functions from class SoBaseList:

     void                SoPathListInsert(SoPathList *this, SoBase *ptr, int
                              addBefore)
     void                SoPathListRemove(SoPathList *this, int which)
     void                SoPathListTruncate(SoPathList *this, int start)
     void                SoPathListSet(SoPathList *this, int i, SoBase *ptr)
     void                SoPathListAddReferences(SoPathList *this, SbBool
                              flag)

          Functions from class SbPList:

     int                 SoPathListFind(const SoPathList *this, const void
                              *ptr)
     int                 SoPathListGetLen(const SoPathList *this)
     int                 SoPathListIsEq(const SoPathList *this, const SbPList
                              *pl)
     int                 SoPathListIsNEq(const SoPathList *this, const SbPList
                              *pl)


DESCRIPTION
     This subclass of SoBaseList holds lists of pointers to SoPaths. It
     updates reference counts to paths in the list whenever adding or removing
     pointers.

FUNCTIONS
     SoPathList *        SoPathListCreate()
          Constructor.
     SoPathList *        SoPathListCreateSize(int size)
          Constructor that pre-allocates storage for size pointers.

     void                SoPathListDelete(SoPathList *this)
          Destructor.

     void                SoPathListAppend(SoPathList *this, SoPath *path)
          Adds a path to the end of the list.

     SoPath *            SoPathListUnknownOperator(const SoPathList *this, int
                              i)
          Accesses an element of a list.

     SoPathList *        SoPathListCopy(SoPathList *this, const SoPathList *l)
          Copies a list, keeping all reference counts correct.

     int                 SoPathListFindPath(SoPathList *this, const SoPath
                              *path)
          Returns the index of the matching path in the list, or -1 if not
          found.

     void                SoPathListSort(SoPathList *this)
          Sorts list in place based on (1) increasing address of head node,
          then (2) increasing indices of children.

     void                SoPathListUniquify(SoPathList *this)
          Given a sorted list, removes any path that (1) is a duplicate, or
          (2) goes through a node that is the tail of another path.


SEE ALSO
     SoPath