ActionScript for Flash MX: The Definitive Guide, Second Edition

Array.concat() Method

This is the Title of the Book, eMatter Edition

Copyright © 2007 O’Reilly & Associates, Inc. All rights reserved.

444

|

ActionScript Language Reference

also the [] and dot operators, which are used to access array elements and form array

literals, as described in Chapter 5.

Usage

If the Array constructor is invoked with a single integer argument, that argument is used to

set the length of the new array, which is then filled with

undefined values. If two or more

arguments are supplied to the constructor or if a single nonnumeric argument is supplied

to the constructor, the arguments are used as the initial values for elements in the array,

and the length of the array is determined by the number of arguments specified.

Array.concat() Method

create a new array by extending an existing array

Flash 5

array.concat(value1, value2, value3,...valuen)

Arguments

value1, ...valuen

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(),orshift()

method to modify the original array.

If an array is used as an argument to concat(), each element of that array is appended sepa-

rately. That is, the result