Diff for "Strings"

Differences between revisions 27 and 30 (spanning 3 versions)

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.function(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.function(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.

Click each function name in the table below for more details of it, with examples.

Functions

Function	Type	Description
CenterPad	String	Prepends and appends spaces (or specified character) to a string to form string of the desired length.
charAt	String	Returns the character in the position specified by the index parameter.
charCodeAt	Number	Returns the numeric Unicode character code of the character at the specified index.
concat	String	Appends the supplied arguments to the end of the String object, converting them to strings if necessary, and returns the resulting string.
fromCharCode	String	Returns a string comprising the characters represented by the Unicode character codes in the parameters.
indexOf	int	Searches the string and returns the position of the first occurrence of val found at or after startIndex within the calling string.
lastIndexOf	int	Searches the string from right to left and returns the index of the last occurrence of val found before startIndex.
LeftPad	String	Prepends spaces (or specified character) to a string to form string of the desired length.
localeCompare	int	Compares the sort order of two or more strings and returns the result of the comparison as an integer.
match	Array	Matches the specifed pattern against the string.
Merge	String	Concatenate str1 and str2 together, delim is inserted between strings if both strings are not empty
replace	String	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.
RightPad	String	Appends spaces (or specified character) to a string to form string of the desired length.
search	int	Searches for the specifed pattern and returns the index of the first matching substring.
slice	String	Returns a string that includes the startIndex character and all characters up to, but not including, the endIndex character.
split	Array	Splits a String object into an array of substrings by dividing it wherever the specified delimiter parameter occurs.
StringRepeat	String	Makes a string consisting of spaces (or of specified string) repeated count times.
StringToObject	String	Parses and converts strings with parameters into object.
substr	String	Returns a substring consisting of the characters that start at the specified startIndex and with a length specified by len.
substring	String	Returns a string consisting of the character specified by startIndex and all characters up to endIndex - 1.
ToCSV	String	Converts arguments to comma-separated string with values enclosedi in qouble quotes.
toLocaleLowerCase	String	Returns a copy of this string, with all uppercase characters converted to lowercase.
toLocaleUpperCase	String	Returns a copy of this string, with all lowercase characters converted to uppercase.
toLowerCase	String	Returns a copy of this string, with all uppercase characters converted to lowercase.
toUpperCase	String	Returns a copy of this string, with all lowercase characters converted to uppercase.
Upper1	String	Upper cases the first letter of a string.
valueOf	String	Returns the primitive value of a String instance.

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: split("delimiter")

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:

CategoryFunctions

Strings (last edited 2015-02-08 06:30:49 by LKD70)

-  ⇤ ← Revision 27 as of 2012-12-04 18:33:26 → 
  Size: 7729
  Editor: Inanna
  Comment:
+   ← Revision 30 as of 2014-02-12 00:30:41 → ⇥
  Size: 8722
  Editor: Inanna
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 4:
- .''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.

Click each method name in the table below for more details of it, with examples.

'''Methods'''
||<tablewidth="796px" tableheight="123px"#cccccc>'''Method ''' ||<#cccccc>'''Type''' ||<#cccccc>'''Description '''||||<style="text-align:center"> || ||
+ .''variable.function(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.function(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.

Click each function name in the table below for more details of it, with examples.

'''Functions'''
||<tablewidth="796px" tableheight="123px"#cccccc>'''Function ''' ||<#cccccc>'''Type''' ||<#cccccc>'''Description '''||||<style="text-align:center"> || ||
||[[#centerpad|CenterPad]] ||String ||Prepends and appends spaces (or specified character) to a string to form string of the desired length. ||
-Line 18:
+Line 19:
+||[[#leftpad|LeftPad]] ||String ||Prepends spaces (or specified character) to a string to form string of the desired length. ||
-Line 20:
+Line 22:
+||[[#merge|Merge]] ||String ||Concatenate str1 and str2 together, delim is inserted between strings if both strings are not empty ||
-Line 21:
+Line 24:
+||[[#rightpad|RightPad]] ||String ||Appends spaces (or specified character) to a string to form string of the desired length. ||
-Line 24:
+Line 28:
+||[[#stringrepeat|StringRepeat]] ||String ||Makes a string consisting of spaces (or of specified string) repeated count times. ||
||[[#stringtoobj|StringToObject]] ||String ||Parses and converts strings with parameters into object. ||
-Line 26:
+Line 32:
+||[[#tocsv|ToCSV]] ||String ||Converts arguments to comma-separated string with values enclosedi in qouble quotes. ||
-Line 30:
+Line 37:
+||[[#upper1|Upper1]] ||String ||Upper cases the first letter of a string. ||
-Line 253:
+Line 261:
-ScriptSyntax
+----
CategoryFunctions