The following functions can be used to manipulate and retrieve string details from objects and variables.

These should be written in the following formats:

• variable.method(arguments), example - myVar.subStr(3,2) if your variable name was "myVar" and you wanted to use subStr() to find the 2 characters that begin 3 from the left.

• object.method(arguments), example - city.coords.split(",") if you wanted to split the coordinates of your city into an array to determine the seperate x and y values using the split() function.

Methods

charAt

Usage: charAt(#)

Returns the character in the position specified by the index parameter.

Example:

• // Don't forget almost all internal "counting" starts at 0, not at 1...

• // so the 5th character would actually be 0, 1, 2, 3, 4 <--- 4!

• var="hello"
• echo "The 5th letter in the word hello is: " + var.charAt(4)

Result:

• 00:49:44 The 5th letter in the word hello is: o
• 00:49:45 Script stopped

charCodeAt

Usage: charCodeAt(#)

Returns the numeric Unicode character code of the character at the specified index.

Example:

• var="hello"
• echo "The numeric code of the 5th letter in the word hello is: " + var.charCodeAt(4)

Result:

• 01:04:27 The numeric code of the 5th letter in the word hello is: 111
• 01:04:28 Script stopped

concat

Usage: concat(arg1,arg2,...,argN)

Appends the supplied arguments to the end of the String object, converting them to strings if necessary, and returns the resulting string.

Example:

• var="oompa"
• var2="loompa"
• var3="dance"
• echo var.concat(var2," ",var3)

Result:

• 01:06:48 oompaloompa dance
• 01:06:49 Script stopped

fromCharCode

Usage:

Returns a string comprising the characters represented by the Unicode character codes in the parameters.

Example:

Result:

indexOf

Usage:

Searches the string and returns the position of the first occurrence of val found at or after startIndex within the calling string.

Example:

Result:

lastIndexOf

Usage:

Searches the string from right to left and returns the index of the last occurrence of val found before startIndex.

Example:

Result:

localeCompare

Usage:

Compares the sort order of two or more strings and returns the result of the comparison as an integer.

Example:

Result:

match

Usage:

Matches the specifed pattern against the string.

Example:

Result:

replace

Usage:

Matches the specifed pattern against the string and returns a new string in which the first match of pattern is replaced with the content specified by repl.

Example:

Result:

search

Usage:

Searches for the specifed pattern and returns the index of the first matching substring.

Example:

Result:

slice

Usage:

Returns a string that includes the startIndex character and all characters up to, but not including, the endIndex character.

Example:

Result:

split

Usage:

Splits a String object into an array of substrings by dividing it wherever the specified delimiter parameter occurs.

Example:

• mycoords=city.coords.split(",")
• echo "x:" + mycoords[0] + " y:" + mycoords[1]

Result:

• 01:08:42 x:746 y:34
• 01:08:43 Script stopped

substr

Usage:

Returns a substring consisting of the characters that start at the specified startIndex and with a length specified by len.

Example:

Result:

substring

Usage:

Returns a string consisting of the character specified by startIndex and all characters up to endIndex - 1.

Example:

Result:

toLocaleLowerCase

Usage:

Returns a copy of this string, with all uppercase characters converted to lowercase.

Example:

Result:

toLocaleUpperCase

Usage:

Returns a copy of this string, with all lowercase characters converted to uppercase.

Example:

Result:

toLowerCase

Usage:

Returns a copy of this string, with all uppercase characters converted to lowercase.

Example:

Result:

toUpperCase

Usage:

Returns a copy of this string, with all lowercase characters converted to uppercase.

Example:

Result:

valueOf

Usage:

Returns the primitive value of a String instance.

Example:

Result:

---

ScriptVariables