SbString(3IV)

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.

FILE FORMAT/DEFAULTS
     String {
     }

SEE ALSO
     SbName