This topic applies to SDL script extensions for TDK. For more information, see Overview of SDL script extensions for TDK (SDL script).

The definition (and some implementation) of the TItsStr class is available in the ItsStr.h header file, located under the Modeler installation directory at <installation directory>\ItsShadow\TdkSources\BiCommon

Reference for using the TItsStr class

Definition: class TItsStr. Aliases: TStr

TItsSr inherits from TItsShortStr for internal reasons. TItsShortStr shall never been used directly by the user.

Constructors and destructor:

Builds a new string object initially empty. An empty string appears externally like a C char pointer to a NUL character

Builds a new string and sets it to the string pointed by S – the string pointed by S is copied internally so the value pointed by S does not need to persist

Builds a new string and sets it to the value pointed by Start and FirstAfterEnd, that must point different characters of the same string. The value is set in such a way all the characters between the one pointed by Start (included) and the one pointed by FirstAfterEnd (excluded) are copied into the string internal buffer

Copy constructor

Copy constructor from base type, do not use

Redefined assignment operator for character expressions, replaces the content of the string object with the string specified (same effect of Set (S))

Empties the string then sets it to the value pointed by Start and FirstAfterEnd, that must point different characters of the same string. The value is set in such a way all the characters between the one pointed by Start (included) and the one pointed by FirstAfterEnd (excluded) are copied into the string internal buffer

Appends C at the end of the string

Appends the string pointed by S at the end of the string object

Appends the string pointed by S at the end of the string object. Instead of evaluating the length of the string pointed by S, trusts the SLen indication provided by the caller. It is more efficient but it may cause errors if such indication is not correct

Appends the specified string at the end of the string object contents if the contents do not terminate with the same string already

Redefined += operators for appending a single character and a string, respectively

Prepend (insert at the beginning of the string) a single character and a string, respectively

Indents the string adding “In” spaces at the beginning of each line (i.e. at the beginning of the whole string, and after each \n character, except the last \n if it is the last character of the string). When used with negative “In”, outdents the string. Outdenting does not preserve original indentation if a negative “In” value is specified such that the (absolute value of) “In” exceeds the count of leading spaces on each line in the string object

Appends N times the character C

Truncates the string object contents at the specified position (0 = truncate to zero characters). Does nothing if Where is specified out of bounds

Deletes the first Num characters of the string contents. If Num is more than the length of the contents, deletes all characters and the string remains empty

Deletes the last Num characters of the string contents. If Num is more than the length of the contents, deletes all characters and the string remains empty

If the contents end with the string specified by What, deletes What from the end of the string and returns true

If the contents start with the string specified by What, deletes What from the beginning of the string and returns true

Deletes all the leading characters equal to the specified character

Deletes all the trailing characters equal to the specified character

Deletes all the leading and trailing characters equal to the specified character

Sets the string pointed by S as the separator that will be appended before any Append, AppendLen operation. The separator will be appended to the string object only if the string object is not empty. Set an empty string to reset the separator to its default empty value

Change the case of all characters in the string to upper case and lower case, respectively

Bytewise compares the string contents against the supplied S value and returns -1, 0, 1 if the contents are lower, equal or greater with respect to S. Comparison is case sensitive

Redefined comparison operators for a string object second operand

Redefined comparison operators for a const char* second operand

Redefined assignment operator

Returns the string object contents as a constant pointer. When the string object is empty, returns a pointer to the NUL character

Redefined cast operator to const char*, has the same effects of Get

Redefined [] operator, returns the character at the specified position

Return the length of the string object contents (excludes any terminating NUL character)

Returns the last character of the string object contents (or NUL if empty)

Returns true if the string object contents ends with the specified string

Returns true if the string object contents starts with the specified string

Finds the Pattern within the contents and returns the number of occurrences found

Replaces each occurrence of Pattern with Substitution and returns the number of substitutions made

Finds the first occurrence of Pattern in the contents. If found, deletes all the characters before Pattern and returns true. In addition, if LeavePatternThere is false, also deletes the pattern itself

Finds the last occurrence of Pattern in the contents. If found, deletes all the characters after Pattern and returns true. In addition, if LeavePatternThere is false, also deletes the pattern itself

Returns a stream object to append expressions at the end of the string object, e.g. MyString.O() << “I was born in “ << 1963;