SoMFName(3)

✨ NAME ✨

okay bestie, welcome to the SoMFName(3) manual page from the Library Functions Manual — and no cap, this is the SoMFName class, a container for SbName values. She’s giving field energy and she’s iconic. 💅

---

🌸 SYNOPSIS 🌸

#include <Inventor/fields/SoMFName.h>

Inherits SoMField. the ancestry is real.

🎀 Public Member Functions 🎀

the whole main-character roster, exactly as written, no skips:

• virtual SoType getTypeId (void) const
• virtual void copyFrom (const SoField &field)
• const SoMFName & operator= (const SoMFName &field)
• virtual SbBool isSame (const SoField &field) const
• const SbName & operator[] (const int idx) const
• const SbName * getValues (const int start) const
• int find (const SbName &value, SbBool addifnotfound=0)
• void setValues (const int start, const int num, const SbName *newvals)
• void set1Value (const int idx, const SbName &value)
• void setValue (const SbName &value)
• const SbName & operator= (const SbName &val)
• SbBool operator== (const SoMFName &field) const
• SbBool operator!= (const SoMFName &field) const
• SbName * startEditing (void)
• void finishEditing (void)
• void setValues (const int start, const int num, const char *strings[])
• void setValue (const char *str)

💖 Public Member Functions inherited from SoMField 💖

hand-me-downs but make them slay:

• virtual ~SoMField ()
• int getNum (void) const
• void setNum (const int num)
• virtual void deleteValues (int start, int num=-1)
• virtual void insertSpace (int start, int num)
• SbBool set1 (const int index, const char *const valuestring)
• void get1 (const int index, SbString &valuestring)
• virtual void enableDeleteValues (void)
• virtual SbBool isDeleteValuesEnabled (void)

🦋 Public Member Functions inherited from SoField 🦋

okay this one’s long, but we do not skip a single one, bestie:

• virtual ~SoField ()
• void setIgnored (SbBool ignore)
• SbBool isIgnored (void) const
• void setDefault (SbBool def)
• SbBool isDefault (void) const
• SbBool isOfType (const SoType type) const
• void enableConnection (SbBool flag)
• SbBool isConnectionEnabled (void) const
• SbBool connectFrom (SoEngineOutput *master, SbBool notnotify=0, SbBool append=0)
• SbBool appendConnection (SoEngineOutput *master, SbBool notnotify=0)
• void disconnect (SoEngineOutput *engineoutput)
• SbBool isConnectedFromEngine (void) const
• SbBool getConnectedEngine (SoEngineOutput *&master) const
• SbBool connectFrom (SoField *master, SbBool notnotify=0, SbBool append=0)
• SbBool appendConnection (SoField *master, SbBool notnotify=0)
• void disconnect (SoField *field)
• SbBool isConnectedFromField (void) const
• SbBool getConnectedField (SoField *&master) const
• int getNumConnections (void) const
• int getForwardConnections (SoFieldList &slavelist) const
• int getConnections (SoFieldList &masterlist) const
• void disconnect (void)
• SbBool isConnected (void) const
• void setContainer (SoFieldContainer *cont)
• SoFieldContainer * getContainer (void) const
• SbBool set (const char *valuestring)
• void get (SbString &valuestring)
• SbBool shouldWrite (void) const
• virtual void touch (void)
• virtual void startNotify (void)
• virtual void notify (SoNotList *nlist)
• SbBool enableNotify (SbBool on)
• SbBool isNotifyEnabled (void) const
• void addAuditor (void *f, SoNotRec::Type type)
• void removeAuditor (void *f, SoNotRec::Type type)
• int operator== (const SoField &f) const
• int operator!= (const SoField &f) const
• virtual void connectionStatusChanged (int numconnections)
• SbBool isReadOnly (void) const
• virtual void fixCopy (SbBool copyconnections)
• virtual SbBool referencesCopy (void) const
• void copyConnection (const SoField *fromfield)
• virtual SbBool read (SoInput *in, const SbName &name)
• virtual void write (SoOutput *out, const SbName &name) const
• virtual void countWriteRefs (SoOutput *out) const
• void setFieldType (int type)
• int getFieldType (void) const
• SbBool getDirty (void) const
• void setDirty (SbBool dirty)
• void evaluate (void) const

🌟 Static Public Member Functions 🌟

static girlies, standing on business:

• static void * createInstance (void)
• static SoType getClassTypeId (void)
• static void initClass (void)

🌈 Static Public Member Functions inherited from SoMField 🌈

• static SoType getClassTypeId (void)
• static void initClass (void)

💜 Static Public Member Functions inherited from SoField 💜

• static void initClass (void)
• static void initClasses (void)
• static SoType getClassTypeId (void)

🧚 Protected Member Functions 🧚

for the internal besties only:

• virtual void deleteAllValues (void)
• virtual void copyValue (int to, int from)
• virtual int fieldSizeof (void) const
• virtual void * valuesPtr (void)
• virtual void setValuesPtr (void *ptr)
• virtual void allocValues (int num)

🍓 Protected Member Functions inherited from SoMField 🍓

• SoMField (void)
• virtual void makeRoom (int newnum)

💜 Protected Member Functions inherited from SoField 💜

• SoField (void)
• void valueChanged (SbBool resetdefault=1)
• virtual void evaluateConnection (void) const
• virtual SbBool readConnection (SoInput *in)
• virtual void writeConnection (SoOutput *out) const
• SbBool isDestructing (void) const

🎀 Protected Attributes 🎀

• SbName * values

🌸 Protected Attributes inherited from SoMField 🌸

• int num
• int maxNum
• SbBool userDataIsUsed

🌈 Additional Inherited Members 🌈

Public Types inherited from SoField

• enum FieldType { NORMAL_FIELD = 0, EVENTIN_FIELD, EVENTOUT_FIELD, EXPOSED_FIELD }

---

🔥 <orange>Detailed Description</orange> 🔥

The SoMFName class is a container for SbName values. she holds the names, bestie.

This field is used where nodes, engines or other field containers needs to store arrays of names.

See also

• SoSFName

---

👑 Member Function Documentation 👑

SoType SoMFName::getTypeId (void ) const [virtual]

Returns the type identification instance which uniquely identifies the Coin field class the object belongs to.

See also

• getClassTypeId(), SoType

Implements SoField.

void SoMFName::copyFrom (const SoField & f) [virtual]

Copy value(s) from f into this field. f must be of the same type as this field.

Implements SoField.

SbBool SoMFName::isSame (const SoField & f) const [virtual]

Check for equal type and value(s).

Implements SoField.

void SoMFName::deleteAllValues (void ) [protected], [virtual]

This API member is considered internal to the library, as it is not likely to be of interest to the application programmer.

Implements SoMField.

void SoMFName::copyValue (int to, int from) [protected], [virtual]

This method is used for moving values around internally within a multivalue field. It needs to be overridden in each field so it automatically takes care of running copy contructors where necessary.

Implements SoMField.

const SbName * SoMFName::getValues (const int start) const [inline]

Returns a pointer to the values array.

References SoMField::num.

void SoMFName::setValues (const int start, const int numarg, const char * strings[])

Set num strings from index start in this multiple-value field instance.

References SoMField::maxNum, SoMField::num, and SoField::valueChanged().

void SoMFName::setValue (const char * str)

Set this field to contain only a single name, given by str.

---

✨ Author ✨

Generated automatically by Doxygen for Coin from the source code. ngl, Doxygen did the typing, not me.

---

mwah 💋 this was Coin, version 2.5.0, source code energy, and the footer didn’t show a date — so that’s the whole SoMFName(3) vibe, bestie. 🫶💅