Documentation for: ASP.NET Ajax Version 1.0

This documentation is for a previous version. For the current released version, see the ASP.NET Ajax documentation on MSDN.

 

 

 

 

 

 

 

Array.clone Function

Creates a shallow copy of an Array object. This function is static and can be invoked without creating an instance of the object.

Syntax

var cloneVar = Array.clone(array);

Arguments

Term

Definition

array

The array to create a shallow copy of.

Remarks

Use the clone function to create a shallow copy of an Array object. A shallow copy contains only the elements of the array, whether they are reference types or value types. However, it does not contain the referenced objects. The references in the new Array object point to the same objects as in the original Array object. In contrast, a deep copy of an Array object copies the elements and everything directly or indirectly referenced by the elements.

note

In Mozilla Firefox version 2.0.0.1 and earlier, the Array.addRange and Array.clone functions might drop elements from the ends of large, sparse arrays.

Example

The following code example demonstrates how to create a copy of an array using the clone function.

JavaScript

var a = ['a', 'b', 'c', 'd'];
var b = Array.clone(a);
// View the results: "abcd"
alert(b.toString());