as3corelib Tutorial:How to Use ArrayUtil Class in Flex

September 1st, 2008 Ntt.cc

ArrayUtil class contains static utility methods for manipulating and working with Arrays. Note that all APIs assume that they are working with well formed arrays. I.e. they will only manipulate indexed values.

Compares two arrays and returns a boolean indicating whether the arrays contain the same values at the same indexes.

Parameters:

arr1:Array The first array that will be compared to the second.

Arr2:Array The second array that will be compared to the first.

Returns:

Boolean True if the arrays contains the same values at the same indexes.

False if they do not.

3. copyArray():

public static function copyArray(arr:Array):Array

Creates a copy of the specified array. Note that the array returned is a new array but the items within the array are not copies of the items in the original array (but rather references to the same items).

Parameters:

arr:Array The array that will be copies

Returns:

Array A new array which contains the same items as the array passed in.

4. createUniqueCopy()

public static function createUniqueCopy(a:Array):Array

Create a new array that only contains unique instances of objects in the specified array. Basically, this can be used to remove duplication object instances from an array

Parameters:

a:Array The array which contains the values that will be used to create the new array that contains no duplicate values.

Returns:

Array A new array which only contains unique items from the specified array.

In this demo, “array1” is the same as “array2” and a little different with “array3”, the order of their elements is different.

Enter any value of the elements of array1 into the input box contained in the row which owns button “arrayContainsValue”. Then, click the button, a dialog pop up to show the result whether the element with the input value is contained in array1.

“arraysAreEqual” compares “array1” with “array2” and “array1” with “array3”.

“copyArray” copy “array1”and add a new TextInput to show the copied array.

“createUniqueArray” is similar as “copyArray”. But its elements are unique.

Enter the value of elements in Array1 into the input box beside “removeValueFromArray”, then, click the button to implement the method.