SbString.3coin4 - Man Page

SbString (void)
SbString (const char *s)
SbString (const wchar_t *s)
SbString (const char *s, int start, int end)
SbString (const SbString &s)
SbString (const int digits)
~SbString ()
uint32_t hash (void) const
int getLength (void) const
void makeEmpty (SbBool freeold=TRUE)
const char * getString (void) const
SbString getSubString (int startidx, int endidx=-1) const
void deleteSubString (int startidx, int endidx=-1)
void addIntString (const int value)
char operator[] (int index) const
SbString & operator= (const char *s)
SbString & operator= (const SbString &s)
SbString & operator+= (const char *s)
SbString & operator+= (const SbString &s)
SbString & operator+= (const char c)
int operator! (void) const
int compareSubString (const char *text, int offset=0) const
SbString & sprintf (const char *formatstr,...)
SbString & vsprintf (const char *formatstr, va_list args)
void apply (char(*func)(char input))
int find (const SbString &s) const
SbBool findAll (const SbString &s, SbIntList &found) const
SbString lower () const
SbString upper () const
void print (std::FILE *fp) const

static uint32_t hash (const char *s)

(Note that these are not member symbols.)

int operator== (const SbString &str, const char *s)
int operator== (const char *s, const SbString &str)
int operator== (const SbString &str1, const SbString &str2)
int operator!= (const SbString &str, const char *s)
int operator!= (const char *s, const SbString &str)
int operator!= (const SbString &str1, const SbString &str2)
int operator< (const SbString &str, const char *s)
int operator< (const char *s, const SbString &str)
int operator< (const SbString &str1, const SbString &str2)
int operator> (const SbString &str, const char *s)
int operator> (const char *s, const SbString &str)
int operator> (const SbString &str1, const SbString &str2)
const SbString operator+ (const SbString &str1, const SbString &str2)
const SbString operator+ (const SbString &sbstr, const char *s)
const SbString operator+ (const char *s, const SbString &sbstr)

This is the default constructor. It initializes the string to be empty.

This constructor assigns from the given string.

This constructor converts the given string to UTF-8 and assigns it.

This constructor constructs a string from the given substring from start to end indices inclusive. If end is -1, the substring from start until the end of the string is used.

This is the copy constructor.

Construct an SbString instance containing the digits of the integer argument.

The destructor. Deallocates any internal resources used during the lifetime of the SbString instance.

This method returns a reasonable hash value for the current string.

See also

uint32_t SbString::hash(const char * s)

This static method returns a hash value for the given string.

This method returns the length of the string.

This method clears the string, making it an empty string (''). If freeold is TRUE (which is the default), the memory used by the old string is freed. Otherwise, memory will be kept and reused when the string is manipulated later.

This method returns the pointer to the string (character array).

This method returns a new string which contains a substring defined by the given indices startidx and endidx (inclusive).

If endidx is -1, the substring from startidx to the end of the string is used.

This will return a string which is (endidx - startidx + 1) characters long, i.e. if this string is 'foo/bar' and we call by SbString::getSubString(0, 3), the returned string will be 'foo/'.

This method deletes the substring defined by startidx and endidx (inclusive). If endidx is -1, the substring from startidx to the end of the string is deleted.

Constructs a string from the given integer (e.g. intToString(42) creates the string '42'), and adds this to the contents of the string.

Returns character at position index in the string.

See also

getSubString()

This is the assignment operator.

Assign from the given string.

Concatenate the given string to the end of the current one.

Concatenate the given string to the end of the current one.

Concatenate the given character to the end of the current string.

Note

This member function is not compatible with OpenInventor.

This unary operator results in TRUE if the current string is empty ('') or FALSE otherwise.

Uses text as a substring to be compared to the string, starting at offset offset. Return value is 0 upon success, and the failing character comparison difference upon failure.

Set SbString instance to the formatted string formatstr, replacing the current contents. The control characters within formatstr and the remaining arguments should follow the conventions of the printf() call.

Note that this function is not part of the original Open Inventor API.

Set SbString instance to the formatted string formatstr, replacing the current contents. The control characters within formatstr and the arguments of the args argument list should follow the conventions of the printf() call.

Note that this function is not part of the original Open Inventor API.

Apply the conversion function func to every character of the current string. func is a pointer to a function that takes a character as input and returns a (probably converted) character.

Note that this function is not part of the original Open Inventor API.

If s is found, the method returns the first index where s starts. Otherwise it returns -1.

Note: SbString::find() is a Coin specific extension to the original Open Inventor API.

See also

SbString::findAll()

Since

Coin 2.0

All occurrences of str is represented in found as indices to the characters where str starts. If 1 or more is found, TRUE is returned, else FALSE is returned.

Note: SbString::findAll() is an extension to the original Open Inventor API.

See also

SbString::find()

Since

Coin 2.0

Converts all of the characters to lowercase using tolower().

Since

Coin 3.1

Converts all of the characters to uppercase using toupper().

Since

Coin 3.1

Dump the state of this object to the fp file stream. Only works in debug version of library, method does nothing in an optimized build.

Equality operator. Check if the strings have the same contents.

Equality operator. Check if the strings have the same contents.

Equality operator. Check if the strings have the same contents.

Inequality operator.

Inequality operator.

Inequality operator.

Less than operator. Results in TRUE if the first character that does not match has a lower value in str than in s.

Less than operator. Results in TRUE if the first character that does not match has a lower value in s than in str.

Less than operator. Results in TRUE if the first character that does not match has a lower value in str1 than in str2.

Greater than operator. Results in TRUE if the first character that does not match has a higher value in str than in s.

Greater than operator. Results in TRUE if the first character that does not match has a higher value in s than in str.

Greater than operator. Results in TRUE if the first character that does not match has a higher value in str1 than in str2.

Addition operator.

Addition operator.

Addition operator.