SoSFName(3IV)

NAME
     SoSFName (SoSName) - field containg a name

INHERITS FROM
     SoField > SoSField > SoSFName

SYNOPSIS
     #include <Inventor_c/fields/SoSFName.h>

     typedef SoSFName    SoSName

          Functions from class SoSFName:

     void                SoSNameSetStr(SoSName *this, const char *string)
     SoType              SoSNameGetClassTypeId()
     void                SoSNameGetTypeId(const SoSName *this)
     const SbName *      SoSNameGet(const SoSName *this)
     void                SoSNameSet(SoSName *this, const char * newValue)
     int                 SoSNameIsEq(const SoSName *this, const SoSFName *f)
     int                 SoSNameIsNEq(const SoSName *this, const SoSFName *f)

          Functions from class SoField:

     void                SoSNameSetIgnored(SoSName *this, SbBool ignore)
     SbBool              SoSNameIsIgnored(const SoSName *this)
     SbBool              SoSNameIsDflt(const SoSName *this)
     SbBool              SoSNameIsOfType(const SoSName *this, SoType type)
     SbBool              SoSNameSetFromStr(SoSName *this, const char
                              *valueString)
     void                SoSNameGetIntoStr(SoSName *this, SbString
                              *valueString)
     void                SoSNameTouch(SoSName *this)
     SbBool              SoSNameConnFromField(SoSName *this, SoField
                              *fromField)
     SbBool              SoSNameConnFrom(SoSName *this, SoEngineOutput
                              *fromEngine)
     void                SoSNameDisconn(SoSName *this)
     SbBool              SoSNameIsConn(const SoSName *this)
     SbBool              SoSNameIsConnFromField(const SoSName *this)
     SbBool              SoSNameGetConnField(const SoSName *this, SoField
                              **writingField)
     SbBool              SoSNameIsConnFromEngine(const SoSName *this)
     SbBool              SoSNameGetConnEngine(const SoSName *this,
                              SoEngineOutput **engineOutput)
     void                SoSNameEnableConn(SoSName *this, SbBool flag)
     SbBool              SoSNameIsConnEnabled(const SoSName *this)
     int                 SoSNameGetForwardConn(const SoSName *this,
                              SoFieldList *list)
     SoFieldContainer *  SoSNameGetContainer(const SoSName *this)
DESCRIPTION
     A field containing a name. Names are short series of characters generally
     used for labels or names, and are stored in a special table designed to
     allow fast lookup and comparison. For most purposes, an SoSFString field
     is probably more appropriate.

     SoSFNames are written to file as a string of characters. Names must begin
     with an underscore or alphabetic character, and must consist entirely of
     underscores, alphabetic characters, or numbers.

FUNCTIONS
     void                SoSNameSetStr(SoSName *this, const char *string)
          Set this field to the name equivalent to the given string.

     SoType              SoSNameGetClassTypeId()
     void                SoSNameGetTypeId(const SoSName *this)
          Returns the type for this class or a particular object of this
          class.

     const SbName *      SoSNameGet(const SoSName *this)
          Returns this field's value.

     void                SoSNameSet(SoSName *this, const char * newValue)
          Sets this field to newValue.

     int                 SoSNameIsEq(const SoSName *this, const SoSFName *f)
     int                 SoSNameIsNEq(const SoSName *this, const SoSFName *f)
          Returns TRUE if f is of the same type and has the same value as this
          field.


SEE ALSO
     SoField, SoSField, SoMFName