read/write index operator

NOTE: unlike the read-only indexer, the terminating 0 is NOT a valid part of the string because it may not be overwritten!!!

reserve internal buffer size to prevent heap allocs

Reserves internal space to prevent excessive heap re-allocations. If you plan to do many Append() operations this may help alot.

tokenize string into a provided String array (faster if tokens array can be reused)

Tokenize the string into a String array.

Parameters:

whiteSpace

a string containing the whitespace characters

Returns:

a string array of tokens

tokenize string into a provided String array, SLOW since new array will be constructed

This is the slow-but-convenient Tokenize() method. Slow since the returned string array will be constructed anew with every method call. Consider the Tokenize() method which takes a string array as input, since this may allow reusing of the array, reducing heap allocations.

tokenize string, keep strings within fence characters intact (faster if tokens array can be reused)

Tokenize a string, but keeps the string within the fence-character intact. For instance for the sentence:

He said: "I don't know."

A Tokenize(" ", '"', tokens) would return:

token 0: He token 1: said: token 2: I don't know.

tokenize string, keep strings within fence characters intact, SLOW since new array will be constructed

Slow version of Tokenize() with fence character. See above Tokenize() for details.

extract substring

Extract a substring range.

extract substring to end of this string

Extract a substring until the end of the original string.

terminate string at first occurence of character in set

Terminates the string at the first occurance of one of the characters in charSet.

return start index of substring, or InvalidIndex if not found

Return the index of a substring, or InvalidIndex if not found.

return index of character in string, or InvalidIndex if not found

Return index of character in string, or InvalidIndex if not found.

terminate string at given index

Terminates the string at the given index.

returns true if string contains any character from set

Returns true if string contains one of the characters from charset.

delete characters from charset at left side of string

Removes all characters in charSet from the left side of the string.

delete characters from charset at right side of string

Removes all characters in charSet from the right side of the string.

trim characters from charset at both sides of string

Trim both sides of a string.

substitute every occurance of a string with another string

Substitute every occurance of origStr with substStr.

substiture every occurance of a character with another character

Replace character with another.

return true if string only contains characters from charSet argument

Return true if the string only contains characters which are in the defined character set.

pattern matching

Pattern-matching, TCL-style.

return a 32-bit hash code for the string

This method computes a hash code for the string. The method is compatible with the Util::HashTable class.

set as char ptr, with explicit length

Sets a new string content. This will handle all special cases and try to minimize heap allocations as much as possible.

return contents as integer

Returns content as integer. Note: this method doesn't check whether the contents is actually a valid integer. Use the IsValidInteger() method for this!

return contents as float

Returns content as float. Note: this method doesn't check whether the contents is actually a valid float. Use the IsValidInt() method for this!

return contents as float2

Returns content as float2. Note: this method doesn't check whether the contents is actually a valid float4. Use the IsValidFloat2() method for this!

return contents as float4

Returns content as float4. Note: this method doesn't check whether the contents is actually a valid float4. Use the IsValidFloat4() method for this!

return contents as matrix44

Returns content as matrix44. Note: this method doesn't check whether the contents is actually a valid matrix44. Use the IsValidMatrix44() method for this!

return true if the content is a valid float

Note: this method is not 100% correct, it just checks for invalid characters.

return true if the content is a valid float2

Note: this method is not 100% correct, it just checks for invalid characters.

return true if the content is a valid float4

Note: this method is not 100% correct, it just checks for invalid characters.

return true if content is a valid matrix44

Note: this method is not 100% correct, it just checks for invalid characters.

get filename extension without dot

Returns:

string representing the filename extension (maybe empty)

convert backslashes to slashes

Converts backslashes to slashes.

remove file extension

Remove the file extension.

extract the part after the last directory separator

Return a String object containing the part after the last path separator.

extract the last directory of the path

Return a String object containing the last directory of the path, i.e. a category.

• 17-Feb-04 floh fixed a bug when the path ended with a slash

extract the part before the last directory separator

Return a String object containing the part before the last directory separator.

NOTE: I left my fix in that returns the last slash (or colon), this was necessary to tell if a dirname is a normal directory or an assign.

• 17-Feb-04 floh fixed a bug when the path ended with a slash

extract path until last slash

Return a path string object which contains of the complete path up to the last slash. Returns an empty string if there is no slash in the path.