SoMFString(3)

📦
version 4.0.10 · 4 versions
, in fedora 43, fedora 44

✨ SoMFString(3) ✨

okay bestie, pull up a chair 🪑 because this is the Coin manual page for SoMFString, straight out of section 3 of the manual, and it's literally a whole vibe. let's get into it 💅

🌸 NAME 🌸

SoMFString — the SoMFString class is a container for SbString values. that's it, that's the whole name section, she's a container, she contains, we love her 🫶

🦋 SYNOPSIS 🦋

#include <Inventor/fields/SoMFString.h>

Inherits SoMField. yes queen, she's part of the family tree 🌳

💖 Public Member Functions 💖

  • virtual SoType getTypeId (void) const
  • virtual void copyFrom (const SoField &field)
  • const SoMFString & operator= (const SoMFString &field)
  • virtual SbBool isSame (const SoField &field) const
  • const SbString & operator[] (const int idx) const
  • const SbString * getValues (const int start) const
  • int find (const SbString &value, SbBool addifnotfound=FALSE)
  • void setValues (const int start, const int num, const SbString *newvals)
  • void set1Value (const int idx, const SbString &value)
  • void setValue (const SbString &value)
  • const SbString & operator= (const SbString &val)
  • SbBool operator== (const SoMFString &field) const
  • SbBool operator!= (const SoMFString &field) const
  • SbString * startEditing (void)
  • void finishEditing (void)
  • void setValues (const int start, const int num, const char *strings[])
  • void setValue (const char *string)
  • void deleteText (const int fromline, const int fromchar, const int toline, const int tochar)

🎀 Public Member Functions inherited from SoMField 🎀

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

🧚 Public Member Functions inherited from SoField 🧚

  • virtual ~SoField ()
  • void setIgnored (SbBool ignore)
  • SbBool isIgnored (void) const
  • void setDefault (SbBool defaultVal)
  • SbBool isDefault (void) const
  • SbBool isOfType (const SoType type) const
  • void enableConnection (SbBool flag)
  • SbBool isConnectionEnabled (void) const
  • SbBool connectFrom (SoEngineOutput *master, SbBool notnotify=FALSE, SbBool append=FALSE)
  • SbBool appendConnection (SoEngineOutput *master, SbBool notnotify=FALSE)
  • void disconnect (SoEngineOutput *engineoutput)
  • SbBool isConnectedFromEngine (void) const
  • SbBool getConnectedEngine (SoEngineOutput *&master) const
  • SbBool connectFrom (SoField *master, SbBool notnotify=FALSE, SbBool append=FALSE)
  • SbBool appendConnection (SoField *master, SbBool notnotify=FALSE)
  • 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 *input, 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 void * createInstance (void)
  • static SoType getClassTypeId (void)
  • static void initClass (void)

🌈 Static Public Member Functions inherited from SoMField 🌈

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

💜 Static Public Member Functions inherited from SoField 💜

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

🔥 Protected Member Functions 🔥

  • 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)
  • virtual SoNotRec createNotRec (SoBase *container)
  • void setChangedIndex (const int chgidx)
  • void setChangedIndices (const int chgidx=-1, const int numchgind=0)

🍓 Protected Member Functions inherited from SoField 🍓

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

👑 Protected Attributes 👑

  • SbString * 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 }

💖 Detailed Description 💖

The SoMFString class is a container for SbString values.

This field is used where nodes, engines or other field containers needs to store arrays of strings. arrays of strings!! plural!! she's holding so many strings bestie, she's booked and busy 💅

See also

SoSFString — her single-value cousin, also iconic, also valid 🫶

💅 Member Function Documentation 💅

void * SoMFString::createInstance (void ) [static]

okay so this API member is considered internal to the library, as it is not likely to be of interest to the application programmer. so like, not for you, bestie, don't worry about it 🙈

Creates a new instance of the class type corresponding to the SoType object. slay.

SoType SoMFString::getClassTypeId (void ) [static]

This static method returns the SoType object associated with objects of this class. it's giving ✨identity✨

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

Returns the type identification of an object derived from a class inheriting SoField. This is used for runtime type checking and "downward" casting. yes, runtime type checking, she knows who she is and she knows who you are 😌

Implements SoField.

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

Copy value(s) from f into this field. f must be of the same type as this field. no mixing, no matching, same type only, that's the rule periodt 💀

Implements SoField.

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

Check for equal type and value(s). a little vibe check, if you will 🦋

Implements SoField.

void SoMFString::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. (again!! internal!! not for us!! we stay out of it 🙈)

Implements SoMField.

void SoMFString::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 constructors where necessary. she's doing the heavy lifting behind the scenes, main character energy fr fr 👑

Implements SoMField.

const SbString * SoMFString::getValues (const int start) const [inline]

Returns a pointer to the values array. pointy pointy ⭐

void SoMFString::initClass (void ) [static]

Internal method called upon initialization of the library (from SoDB::init()) to set up the type system. internal again, bestie, we're just here to witness 🎀

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

Set field to contain num strings from index start, replacing any strings already present at the given indices. she's not adding, she's replacing, no cap.

void SoMFString::setValue (const char * str)

Set field to contain a single string, from str. just one. singular. one single string. it's giving minimalism 💅

void SoMFString::deleteText (const int fromline, const int fromchar, const int toline, const int tochar)

Remove all text from fromchar on fromline and to tochar on toline, including all lines between fromline and toline. Merge fromline and toline after deletion. so like, she's taking out the whole chunk and stitching the two ends back together, surgical behavior, we love to see it 🔥

🎀 Author 🎀

Generated automatically by Doxygen for Coin from the source code. (not a human, a robot, and honestly? she ate 🤖💅)

💖 and that's the whole page bestie!! this was SoMFString(3) from the Coin manual, Version 4.0.10, dated Thu Jun 25 2026 00:00:00. bookmark it, screenshot it, tattoo it, idc — just remember: it's a container for SbString values and she's doing amazing sweetie 🫶✨🌈💜
📦 where this page comes from