Array associativi

Esistono due modi per creare degli array associativi in ActionScript 3.0. Il primo modo consiste nell'utilizzare un'istanza Object. Utilizzando un'istanza Object, è possibile inizializzare l'array con un valore letterale. Un'istanza della classe Object, detta anche oggetto generico , è identica dal punto di vista funzionale a un array associativo. Ogni nome di proprietà dell'oggetto generico funge da chiave che fornisce accesso a un valore memorizzato.

Nell'esempio seguente viene creato un array associativo denominato monitorInfo e viene utilizzato un valore letterale oggetto per inizializzare l'array con due coppie chiave/valore:

var monitorInfo:Object = {type:"Flat Panel", resolution:"1600 x 1200"}; 
trace(monitorInfo["type"], monitorInfo["resolution"]);  
// output: Flat Panel 1600 x 1200

Se non avete l'esigenza di inizializzare l'array quando viene dichiarato, potete utilizzare la funzione di costruzione Object per creare l'array, come indicato di seguito:

var monitorInfo:Object = new Object();

Al termine della creazione dell'oggetto tramite il valore letterale oggetto o la funzione di costruzione della classe Object, è possibile aggiungere nuovi valori all'array mediante l'operatore parentesi ( [] ) o l'operatore punto ( . ). Nell'esempio seguente vengono aggiunti due nuovi valori a monitorArray :

monitorInfo["aspect ratio"] = "16:10"; // bad form, do not use spaces 
monitorInfo.colors = "16.7 million"; 
trace(monitorInfo["aspect ratio"], monitorInfo.colors); 
// output: 16:10 16.7 million

Notate come la chiave denominata aspect ratio contenga un carattere spazio. Questa operazione è possibile con l'operatore di accesso all'array ( [] ), ma genera un errore se si tenta di effettuarla con l'operatore punto. L'uso di spazi nei nomi delle chiavi è sconsigliato.

In alternativa, per creare un array associativo potete utilizzare la funzione di costruzione Array (o la funzione di costruzione di qualsiasi classe dinamica) e utilizzare, quindi, l'operatore di accesso all'array ( [] ) o l'operatore punto ( . ) per aggiungere coppie chiave/valore all'array. Se dichiarate un array associativo di tipo Array, non potete utilizzare un valore letterale oggetto per inizializzare l'array. Nell'esempio seguente viene creato un array associativo denominato monitorInfo utilizzando la funzione di costruzione Array e viene aggiunta una chiave denominata type e una denominata resolution con i relativi valori.

var monitorInfo:Array = new Array(); 
monitorInfo["type"] = "Flat Panel"; 
monitorInfo["resolution"] = "1600 x 1200"; 
trace(monitorInfo["type"], monitorInfo["resolution"]);  
// output: Flat Panel 1600 x 1200

L'uso della funzione di costruzione Array per creare un array associativo non presenta vantaggi. Non potete usare la proprietà Array.length né alcuno dei metodi della classe Array con gli array associativi, anche se utilizzate la funzione di costruzione di Array o il tipo di dati di Array. È preferibile destinare la funzione di costruzione della classe Array alla creazione di array indicizzati.

Con la classe Dictionary è possibile creare array associativi che usano oggetti anziché stringhe come chiavi. Tali array vengono anche chiamati dizionari, hash o mappe. Considerate, ad esempio, un'applicazione che consente di determinare la posizione di un oggetto Sprite in base alla sua associazione a un contenitore specifico. È possibile utilizzare un oggetto Dictionary per mappare ogni oggetto Sprite a un contenitore.

Nel codice seguente vengono create tre istanze della classe Sprite che servono da chiave per l'oggetto Dictionary. A ogni chiave viene assegnato un valore GroupA o GroupB . Tali valori possono essere dati di qualsiasi tipo, tuttavia, nell'esempio, sia GroupA che GroupB sono istanze della classe Object. Di conseguenza, potete accedere al valore associato a ciascuna chiave per mezzo dell'operatore di accesso all'array ( [] ), come mostrato nel seguente codice:

import flash.display.Sprite; 
import flash.utils.Dictionary; 
 
var groupMap:Dictionary = new Dictionary(); 
 
// objects to use as keys 
var spr1:Sprite = new Sprite(); 
var spr2:Sprite = new Sprite(); 
var spr3:Sprite = new Sprite(); 
 
// objects to use as values 
var groupA:Object = new Object(); 
var groupB:Object = new Object(); 
 
// Create new key-value pairs in dictionary. 
groupMap[spr1] = groupA; 
groupMap[spr2] = groupB; 
groupMap[spr3] = groupB; 
 
if (groupMap[spr1] == groupA) 
{ 
    trace("spr1 is in groupA");  
} 
if (groupMap[spr2] == groupB) 
{ 
    trace("spr2 is in groupB");  
} 
if (groupMap[spr3] == groupB) 
{ 
    trace("spr3 is in groupB");  
}

for (var key:Object in groupMap) 
{ 
    trace(key, groupMap[key]); 
} 
/* output: 
[object Sprite] [object Object] 
[object Sprite] [object Object] 
[object Sprite] [object Object] 
*/

for each (var item:Object in groupMap) 
{ 
    trace(item); 
} 
/* output: 
[object Object] 
[object Object] 
[object Object] 
*/

var myObject:Object = new Object();

import flash.utils.Dictionary; 
 
var myObject:Object = new Object(); 
var myMap:Dictionary = new Dictionary(); 
myMap[myObject] = "foo";

myObject = null; 
delete myMap[myObject];

import flash.utils.Dictionary; 
 
var myObject:Object = new Object(); 
var myMap:Dictionary = new Dictionary(true); 
myMap[myObject] = "foo"; 
myObject = null; // Make object eligible for garbage collection.