These functions are used to manipulate strings.

Functions

StringLength StringCopy StringAppend StringMatch StringMatchInsensitive StringClear StringToUpper StringToLower StringToInt StringPrint StringGetChar StringSetChar

StringInsertChar StringDeleteChar StringAppendChar StringStripChar CharToUpper CharToLower CharIsAlpha CharIsDigit CharIsPunct CharIsSpace

function StringLength (String)

Gets the length of a string.

Parameters

String

String index.

Returns

Number of characters in the string.

function StringCopy (Destination, Source)

Copies the source string to the destination string, overwriting the existing string.

Parameters

Destination		Destination string.
Source		Source string.

function StringAppend (Destination, Source)

Appends the source string to the destination string.

Parameters

Destination		Destination string.
Source		Source string.

function StringMatch (String1, String2)

Performs a case-sensitive comparison of each character in the two strings.

Parameters

String1		First string to compare.
String2		Second string to compare.

Returns

True, if every character is the same, otherwise false.

function StringMatchInsensitive (String1, String2)

Performs a case-insensitive comparison of each character the two strings.

Parameters

String1		First string to compare.
String2		Second string to compare.

Returns

True, if every character is the same (without regard to case), otherwise false.

function StringClear (String)

Clears a string (by setting its length to zero).

Parameters

String

Index of tring to clear.

Returns

Index of string that was cleared.

function StringToUpper (String)

Converts all the lowercase characters to uppercase.

Parameters

String

String to convert.

Returns

Index of string that was converted.

function StringToLower (String)

Converts all the uppercase characters to lowercase.

Parameters

String

Index of string to convert.

Returns

Index of string that was converted (same as argument).

function StringToInt (String)

Converts a string of digits into an integer value.

Parameters

String

Index of string to convert.

Returns

Integer value, or 0 if the input string could not be converted.

function StringPrint (Destination, Format, Arguments...)

Similar to the Print statement, but prints to a string instead of a display box. See the documentation for the Print statement for details about format codes.

Parameters

Destination		Index of string.
Format		Format string.
Arguments...		Arguments that will be inserted into the destination string according to the format codes.

See Also...

• Guide: Script Language: Statements: Print

function StringGetChar (String, Position)

Gets a character value at the specified index in the string.

Parameters

String		Index of string.
Position		Position to read the character (in the range of zero to length minus one).

Returns

ASCII value of character at the given position.

function StringSetChar (String, Position, Char)

Sets a character at a position in the string to an ASCII character value.

Parameters

String		Index of string.
Position		Position to assign the character (in the range of zero to length minus one).
Char		ASCII value of the character to assign.

function StringInsertChar (Index, Position, Char)

Inserts a character at a given position in the string.

Parameters

Index		of string.
Position		Position in string.
Char		Character ASCII code.

function StringDeleteChar (String, Position)

Deletes a character from a given position inside a string.

Parameters

String		Index of string.
Position		Position in string.

Returns

ASCII character value that was deleted.

function StringAppendChar (String, Char)

Appends a character to the end of a string.

Parameters

String		Index of string.
Char		Character to append.

function StringStripChar (String)

Strips a character from the end of a string.

Parameters

String

Index of string.

Returns

ASCII-value of character that was stripped.

function CharToUpper (Char)

Converts a character value to uppercase.

Parameters

Char

Character value to convert.

Returns

Uppercase character value.

function CharToLower (Char)

Converts an uppercase character to lowercase.

Parameters

Char

Character value to convert.

Returns

Lowercase character value.

function CharIsAlpha (Char)

Tests whether a value is an alphanumeric character.

Parameters

Char

Character value to test.

Returns

True or false.

function CharIsDigit (Char)

Tests whether a value is a numeric character ('0' to '9').

Parameters

Char

Character value to test.

Returns

True or false.

function CharIsPunct (Char)

Tests whether a value is a punctuation character.

Parameters

Char

Character value to test.

Returns

True or false.

function CharIsSpace (Char)

Tests whether a value is a whitespace character (space, tab, newline, vertical tab.)

Parameters

Char

Character value to test.

Returns

True or false.