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

These should be written in the following format: varname.method(arguments), e.g. myVar.subStr(3,2) if your variable name was "myVar" and you wanted to use the subStr function to find the 2 characters that begin 3 from the left.

Using the table below, you could for example find out the 4th letter of the variable named var that has stored the word "hello" like so:

• // 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:
  01:25:34 The 5th letter in the word hello is: o
  01:25:35 Script stopped

Methods

charAt

Usage: charAt(#)

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

Example:

• 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