---
name: "SbString"
section: "3iv"
platform: "linux"
package: "inventor-doc"
version: "2.1.6+ds-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SbString/3iv"
---

# SbString(3iv)

class for smart character strings

## 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**