User Guide

804 Chapter 2:
String.split()
Availability
Flash Player 5.
Usage
my_str.split("delimiter":String, [limit:Number]) : Number
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
The following example shows that if you use an empty string ("") for the delimiter parameter,
each character in the string is placed as an element in the array:
var my_str:String = new String("Joe");
var my_array:Array = my_str.split("");
for (var i = 0; i<my_array.length; i++) {
trace(my_array[i]);
}