SbName(3IV)

NAME
     SbName (SbName) - character string stored in a hash table

INHERITS FROM
     SbName

SYNOPSIS
     #include <Inventor_c/SbString.h>

          Functions from class SbName:

     SbName *            SbNameCreate()
     SbName *            SbNameCreateStr(const char *s)
     SbName *            SbNameCreateSbStr(const SbString *s)
     SbName *            SbNameCreateSbName(const SbName *n)
     void                SbNameDelete(SbName *this)
     const char *        SbNameGetStr(const SbName *this)
     int                 SbNameGetLen(const SbName *this)
     SbBool              SbNameIsIdentStartChar(char c)
     SbBool              SbNameIsIdentChar(char c)
     int                 SbNameNot(const SbName *this)
     int                 SbNameIsEq(SbName *this, const SbName *n1, const
                              SbName *n2)
     int                 SbNameIsEqStr(SbName *this, const SbName *n, const
                              char *s)
     int                 SbNameIsNEq(SbName *this, const SbName *n1, const
                              SbName *n2)
     int                 SbNameIsNEqStr(SbName *this, const SbName *n, const
                              char *s)


DESCRIPTION
     This class of strings stores the string in a hash table. It is used by
     the Inventor toolkit for keywords and other unique names. It is not
     recommended for general use (only in the context of Inventor objects).
     When a string is stored in this table, a pointer to the storage is
     returned. Two identical strings will return the same pointer. This means
     that comparison of two SbNames for equality can be accomplished by
     comparing their identifiers. SbNames are used for strings which are
     expected to show up frequently, such as node names.

FUNCTIONS
     SbName *            SbNameCreate()
     SbName *            SbNameCreateStr(const char *s)
     SbName *            SbNameCreateSbStr(const SbString *s)
     SbName *            SbNameCreateSbName(const SbName *n)
     void                SbNameDelete(SbName *this)
          Constructors and destructor.

     const char *        SbNameGetStr(const SbName *this)
          Returns pointer to the character string.
     int                 SbNameGetLen(const SbName *this)
          Returns length of string.

     SbBool              SbNameIsIdentStartChar(char c)
          Returns TRUE if given character is a legal starting character for an
          identifier.

     SbBool              SbNameIsIdentChar(char c)
          Returns TRUE if given character is a legal nonstarting character for
          an identifier.

     int                 SbNameNot(const SbName *this)
          Unary "not" operator; returns TRUE if string is empty ("").

     int                 SbNameIsEq(SbName *this, const SbName *n1, const
                              SbName *n2)
     int                 SbNameIsEqStr(SbName *this, const SbName *n, const
                              char *s)
          Equality operator for SbName/char* and SbName/SbName comparison.

     int                 SbNameIsNEq(SbName *this, const SbName *n1, const
                              SbName *n2)
     int                 SbNameIsNEqStr(SbName *this, const SbName *n, const
                              char *s)
          Inequality operator for SbName/char* and SbName/SbName comparison.


FILE FORMAT/DEFAULTS
     Name {
     }

SEE ALSO
     SbString