Core JavaScript 1.5 Reference:Global Objects:Array:join
From MDC
Contents |
[edit] Summary
Joins all elements of an array into a string.
| Method of Array | |
| Implemented in: | JavaScript 1.1, NES 2.0 |
| ECMA Version: | ECMA-262 |
[edit] Syntax
join(separator)
[edit] Parameters
-
separator - Specifies a string to separate each element of the array. The separator is converted to a string if necessary. If omitted, the array elements are separated with a comma.
[edit] Description
The string conversions of all array elements are joined into one string.
[edit] Examples
[edit] Example: Joining an array three different ways
The following example creates an array, a, with three elements, then joins the array three times: using the default separator, then a comma and a space, and then a plus.
var a = new Array("Wind","Rain","Fire");
var myVar1 = a.join(); // assigns "Wind,Rain,Fire" to myVar1
var myVar2 = a.join(", "); // assigns "Wind, Rain, Fire" to myVar2
var myVar3 = a.join(" + "); // assigns "Wind + Rain + Fire" to myVar3