Name
Array.concat( ) Method — create a new array by extending an existing array
Availability
Flash 5
Synopsis
array.concat(value1, value2, value3,...valuen)
Arguments
- value1,...value
n
A list of expressions to be added to the end of
array
as new elements.
Returns
A new array containing all the elements of
array
followed by the elements
value1,...valuen
.
Description
The concat( )
method returns a new array created
by appending new elements to the end of an existing array. The
original array
is left unchanged. Use the
push( )
, splice( )
, or
shift( )
method to modify the original array.
If an array is used as an argument to concat( )
,
each element of that array is appended separately. That is, the
result of arrayX.concat(arrayY)
will be an array
formed by appending each element of arrayY
to the
end of arrayX
. The resulting array will have a
length
equal to arrayY.length + arrayX.length
. Nested arrays, however, are not similarly
flattened.
Example
// Create an array myListA = new Array("apples", "oranges"); // Set myListB to ["apples", "oranges", "bananas"] myListB = myListA.concat("bananas"); // Create another new array myListC = new Array("grapes", "plums"); // Set myListD to ["apples", "oranges", "bananas", "grapes", "plums"] myListD = myListB.concat(myListC); // Set myListA to ["apples", "oranges", "bananas"] myListA = myListA.concat("bananas"); // Create an array settings = ["on", "off"]; // Append an array containing a nested array options = settings.concat(["brightness", ["high", "medium", ...
Get ActionScript: The Definitive Guide now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.