String

String is UTF-8 based string class with heap support. String is the base to the two other classes StringLH and StringDH, allowing all string argument passing to be done by String&, and hence passing a specific derived class is not necessary. By default, String allocates memory from global heap.

Strings do NOT mutate heaps on assignment, so a data copy will be made if a string is copied to a different heap; this data copy and allocation is avoided if heaps on both sides of assignment do match.

Method	Description
AppendChar	Appends a character to the string.
AppendString	Appends a specified string to the end of the string.
AssignString	Assigns a string with dynamic data (copied through initializer).
AssignString	Assigns a string with known size.
BernsteinHashFunction	Case sensitive Bernstein string hash function and computes hash.
BernsteinHashFunctionCIS	Case insensitive Bernstein string hash function and computes hash.
Clear	Deletes the string.
CompareNoCase	Compares two stings and is case-insensitive.
EscapeSpecialHTML	Escapes the encoded/decoded special HTML characters in a string.
GetByteIndex	Gets the byte index of the character at the position specified by the passed index value.
GetCharAt	Returns the character at specified index.
GetExtension	Get file extension with a dot.
GetFilename	Returns the file name, including extension.
GetFirstCharAt	Returns the first character of the UTF-8 character string.
GetHeap	Returns the memory heap used for String based on the HeapType.
GetLength	Returns the number of characters in the string.
GetNextChar	Returns the next character in the UTF-8 encoded character string.
GetPath	Returns file path with trailing '/'.
GetProtocol	Returns protocol, if any, with trailing '://'.
GetSize	Returns the number of bytes in the string.
HasAbsolutePath	Determines whether the file path name is an absolute or relative path.
HasExtension	Determines whether an extension is included along with the file name.
HasProtocol	Determines whether there is any protocol (such as 'file://', 'http://') in front of the string which represents a file path.
Insert	Inserts a substring to the original string at the specified position.
InsertCharAt	Inserts a new character at desired position.
String	String constructors.
IsEmpty	IsEmpty determines whether the string is empty or not.
String	String constructors.
String	Copy constructors.
StripExtension	Strips off trailing extension in the file name.
StripProtocol	Strips off the front protocol, if any, from the string.
Substring	Substring returns a substring of the original String.
ToCStr	ToCStr obtains a pointer to raw buffer of string.
ToLower	Converts the character string to lowercase.
ToUpper	Converts the character string to uppercase.
Remove	Removes the character at the specified index.
UnescapeSpecialHTML	Unescapes the encoded/decoded special HTML characters in a string.

Operator	Description
!=	Determines the inequality of Strings.
[]	Returns the byte in the data array at the specified index.
+	Concatenates two strings.
+=	Returns a new String which is a concatenation of the original string with the parameter.
<	Returns the result of lexicographical comparison between two strings.
=	Assignment operation.
==	Comparison operation.
>	Returns the result of lexicographical comparison between two strings.
const char*	Operator function for casting to a pointer of type char.

Structure	Description
HashFunctor	Hash functor used for strings.
InitStruct	Structure for initializing string with dynamic buffer.
NoCaseHashFunctor	Case -insensitive hash functor used for strings. Supports additional lookup based on NoCaseKey.
NoCaseKey	Structure for case insensitive keys which are used to look up insensitive string in hash tables for SWF files with versions before SWF 7.

SF_String.h