User Guide

416 Chapter 6: ActionScript Core Classes
// slices that omit the end parameter use String.length, which equals 5
trace("slice(0): "+my_str.slice(0)); // slice(0): Lorem
trace("slice(3): "+my_str.slice(3)); // slice(3): em
See also
String.substr(), String.substring()
String.split()
Availability
Flash Player 5.
Usage
my_str.split("delimiter":String, [limit:Number]) : Array
Parameters
delimiter
A string; the character or string at which my_str splits.
limit A number; the number of items to place into the array. This parameter is optional.
Returns
An array; an array containing the substrings of my_str.
Description
Method; splits a String object into substrings by breaking it wherever the specified delimiter
parameter occurs and returns the substrings in an array. If you use an empty string (
"") as a
delimiter, each character in the string is placed as an element in the array.
If the
delimiter parameter is undefined, the entire string is placed into the first element of the
returned array.
Example
The following example returns an array with five elements:
var my_str:String = "P,A,T,S,Y";
var my_array:Array = my_str.split(",");
for (var i = 0; i<my_array.length; i++) {
trace(my_array[i]);
}
/* output:
P
A
T
S
Y
*/
The following example returns an array with two elements, "P" and "A":
var my_str:String = "P,A,T,S,Y";
var my_array:Array = my_str.split(",", 2);
trace(my_array); // output: P,A