NAME

       SbString — class for smart character strings

INHERITS FROM

       SbString

SYNOPSIS

       #include <Inventor/SbString.h>

          Methods from class SbString:

                         SbString()
                         SbString(const char *str)
                         SbString(const char *str, int start, int end)
                         SbString(const SbString &str)
                         SbString(int digitString)
                         ~SbString()
     uint32_t            hash()
     int                 getLength() const
     void                makeEmpty(SbBool freeOld = TRUE)
     const char *        getString() const
     SbString            getSubString(int startChar, int endChar = -1) const
     void                deleteSubString(int startChar, int endChar = -1)
     SbString &          operator =(const char *str)
     SbString &          operator =(const SbString &str)
     SbString &          operator +=(const char *str)
     SbString &          operator +=(const SbString &str)
     int                 operator !() const
     int                 operator ==(const char *s, const SbString &str)
     int                 operator ==(const SbString &str, const char *s)
     int                 operator ==(const SbString &str1, const SbString &str2)
     int                 operator !=(const char *s, const SbString &str)
     int                 operator !=(const SbString &str, const char *s)
     int                 operator !=(const SbString &str1, const SbString &str2)

DESCRIPTION

       Strings which have many convenience methods to make string manipulation easier.

METHODS

                         SbString()
                         SbString(const char *str)
                         SbString(const char *str, int start, int end)
                         SbString(const SbString &str)
                         SbString(int digitString)
                         ~SbString()
          Constructors  and  destructor.  Constructors  take  a character string, the subset of a
          character string from start to end (inclusive), or an  integer  to  be  turned  into  a
          string.  For example, SbString(1234) creates the string "1234". SbString("Testing",1,3)
          creates the string "est".

     uint32_t            hash()
          Returns a reasonable hash key for string.

     int                 getLength() const
          Returns length of string.

     void                makeEmpty(SbBool freeOld = TRUE)
          Sets string to be the empty string (""). If freeOld is TRUE (default), any old  storage
          is freed up.

     const char *        getString() const
          Returns pointer to the character string.

     SbString            getSubString(int startChar, int endChar = -1) const
          Returns  new  string  representing  sub-string from startChar to endChar, inclusive. If
          endChar is -1 (the default), the sub-string from startChar until the end is returned.

     void                deleteSubString(int startChar, int endChar = -1)
          Deletes the characters from startChar  to  endChar,  inclusive,  from  the  string.  If
          endChar is -1 (the default), all characters from startChar until the end are deleted.

     SbString &          operator =(const char *str)
     SbString &          operator =(const SbString &str)
          Assignment operators for character string, SbString.

     SbString &          operator +=(const char *str)
     SbString &          operator +=(const SbString &str)
          Concatenation operators "+=" for string, SbString.

     int                 operator !() const
          Unary "not" operator; returns TRUE if string is empty ("").

     int                 operator ==(const char *s, const SbString &str)
     int                 operator ==(const SbString &str, const char *s)
     int                 operator ==(const SbString &str1, const SbString &str2)
          Equality operator for SbString/char* and SbString/SbString comparison.

     int                 operator !=(const char *s, const SbString &str)
     int                 operator !=(const SbString &str, const char *s)
     int                 operator !=(const SbString &str1, const SbString &str2)
          Inequality operator for SbString/char* and SbString/SbString comparison.

SEE ALSO

       SbName

                                                                                  SbString(3IV)()