| Pacchetto | Primo livello |
| Classe | public dynamic class Vector |
| Ereditarietà | Vector  Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Come con un'istanza Array, potete utilizzare l'operatore di accesso agli array ([]) per impostare o recuperare il valore di un elemento Vector. Diversi metodi Vector forniscono anche meccanismi per importare e recuperare i valori degli elementi. Questi metodi includono push(), pop(), shift(), unshift() e altri. Le proprietà e i metodi di un oggetto Vector sono simili (nella maggior parte dei casi identici) alle proprietà e ai metodi di un'istanza Array. Nella maggior parte dei casi in cui utilizzereste un array e in cui tutti gli elementi appartengono allo stesso tipo di dati, è preferibile utilizzare un'istanza Vector. Le istanze Vector sono tuttavia array di tipo dense e ciò significa che devono avere un valore (oppure null) in ogni posizione di indice. Alle istanze Array non viene applicata questa limitazione.
Il tipo di base del vettore viene specificato utilizzando la sintassi del parametro type in forma suffissa. La sintassi del parametro type è una sequenza formata da un punto (.), parentesi angolare sinistra (<), nome della classe, quindi parentesi angolare destra (>), come nell'esempio seguente:
Nella prima riga dell'esempio, la variabile v viene dichiarata come istanza Vector.<String>. In altre parole, rappresenta un vettore (un array) che può contenere solo istanze String e da cui possono essere recuperate solo istanze String. Nella seconda riga viene costruita un'istanza dello stesso tipo Vector (ovvero un vettore i cui elementi sono tutti istanze String) che viene assegnata a v.
var v:Vector.<String>; v = new Vector.<String>();
Una variabile dichiarata con il tipo di dati Vector.<T> può contenere solo un'istanza Vector costruita con lo stesso tipo di base T. Un vettore costruito, ad esempio, mediante una chiamata a new Vector.<String>() non può essere assegnato a una variabile dichiarata con il tipo di dati Vector.<int>. I tipi di base devono corrispondere esattamente. Il seguente codice, ad esempio, non viene compilato perché il tipo di base dell'oggetto non corrisponde al tipo di base dichiarato della variabile (anche se Sprite è una sottoclasse di DisplayObject):
// This code doesn't compile even though Sprite is a DisplayObject subclass var v:Vector.<DisplayObject> = new Vector.<Sprite>();
Per convertire un vettore con un tipo di base T in un vettore di una superclasse di T, utilizzate la funzione globale Vector().
Oltre alla restrizione relativa al tipo di dati, la classe Vector presenta altre restrizioni che la distinguono dalla classe Array:
- Un vettore è un array di tipo dense. A differenza di un array, che può avere valori negli indici 0 e 7 anche se non sono presenti valori nelle posizioni da 1 a 6, un vettore deve avere un valore (o
null) in ogni posizione di indice. - Un vettore può avere in via facoltativa una lunghezza fissa, vale a dire che il numero di elementi che contiene non può variare.
- L'accesso agli elementi di un vettore è soggetto al controllo dei limiti. Non potete mai leggere un valore da un indice maggiore dell'elemento finale (
length - 1). Non potete mai impostare un valore con un indice maggiore di uno rispetto all'indice finale corrente (in altre parole, potete solo impostare un valore corrispondente a una posizione di indice esistente o[length]).
A causa di queste limitazioni, un Vector presenta tre vantaggi principali rispetto a un'istanza Array, i cui elementi sono tutti istanze di una sola classe:
- Prestazioni: l'iterazione e l'accesso agli elementi dell'array sono molto più veloci quando si utilizza un'istanza Vector rispetto a un'istanza Array.
- Sicurezza del tipo: in modalità rigorosa, il compilatore può identificare gli errori relativi al tipo di dati. Tali errori relativi al tipo di dati possono comprendere l'assegnazione a un vettore di un valore appartenente a un tipo di dati errato o l'attesa di un tipo di dati errato nel corso della lettura di un valore contenuto nel vettore. Notate, tuttavia, che quando si utilizza il metodo
push()ounshift()per aggiungere valori a un vettore, i tipi di dati degli argomenti non vengono verificati in fase di compilazione, bensì in fase di runtime. - Affidabilità: il controllo dell'intervallo (o controllo della lunghezza fissa) in fase di runtime migliora significativamente l'affidabilità rispetto agli array.
Altri esempi
Creazione di un'istanza Vector
Inserimento di elementi di array
Recupero di valori e rimozione degli elementi di un array
Ordinamento di un array
Query di un array
Esempio di array: PlayList
Altre informazioni
Elementi fondamentali degli array
Array indicizzati
Array associativi
Array multidimensionali
Clonazione di array
Elementi API correlati
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| fixed : Boolean
Indica se la proprietà length del vettore può essere modificata. | Vector | ||
| length : uint
L'intervallo di posizioni di indice valide disponibili nel vettore. | Vector | ||
| Metodo | Definito da | ||
|---|---|---|---|
Crea un vettore con il tipo di base specificato. | Vector | ||
Concatena i vettori specificati nell'elenco dei parametri con gli elementi di questo vettore e crea un nuovo vettore. | Vector | ||
Esegue una funzione di prova su ciascun elemento del vettore fino a quando non viene raggiunto un elemento che restituisce false per la funzione specificata. | Vector | ||
Esegue una funzione di prova su ciascun elemento del vettore e restituisce un nuovo vettore contenente tutti gli elementi che restituiscono true per la funzione specificata. | Vector | ||
Esegue una funzione su ciascun elemento nel vettore. | Vector | ||
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
Cerca un elemento nel vettore e restituisce la posizione di indice dell'elemento. | Vector | ||
Inserite un singolo elemento nel vettore. | Vector | ||
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
Converte in stringhe gli elementi di un vettore, inserisce il separatore specificato tra gli elementi, li concatena e restituisce la stringa risultante. | Vector | ||
Cerca un elemento nel vettore a ritroso partendo dalla posizione di indice specificata e restituisce la posizione di indice dell'elemento corrispondente. | Vector | ||
Esegue una funzione su ciascun elemento nel vettore e restituisce un nuovo vettore di elementi corrispondenti ai risultati della chiamata di funzione eseguita su ciascun elemento di questo vettore. | Vector | ||
pop():T
Rimuove l'ultimo elemento dal vettore e lo restituisce. | Vector | ||
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
Aggiunge uno o più elementi alla fine del vettore e ne restituisce la nuova lunghezza. | Vector | ||
Rimuovete un singolo elemento dal vettore. | Vector | ||
Inverte l'ordine degli elementi nel vettore. | Vector | ||
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
shift():T
Rimuove il primo elemento dal vettore e lo restituisce. | Vector | ||
Restituisce un nuovo vettore composto da un intervallo di elementi del vettore originale, senza modificare quest'ultimo. | Vector | ||
Esegue una funzione di prova su ciascun elemento del vettore fino a quando non viene raggiunto un elemento che restituisce true. | Vector | ||
Ordina gli elementi nell'oggetto Vector e inoltre restituisce un oggetto Vector ordinato. | Vector | ||
Aggiunge e rimuove gli elementi di del vettore. | Vector | ||
Restituisce una stringa che rappresenta gli elementi nel vettore specificato. | Vector | ||
Restituisce una stringa che rappresenta gli elementi nel vettore. | Vector | ||
Aggiunge uno o più elementi all'inizio del vettore e ne restituisce la nuova lunghezza. | Vector | ||
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
fixed | proprietà |
fixed:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Indica se la proprietà length del vettore può essere modificata. Se il valore è true, la proprietà length non può essere modificata. Ciò significa che le operazioni seguenti non sono consentite quando fixed è true:
- impostazione diretta della proprietà
length; - assegnazione di un valore alla posizione di indice
length; - chiamata di un metodo che modifichi la proprietà
length, tra cui:pop()push()shift()unshift()splice()(se la chiamata asplice()modifica il valorelengthdel vettore).
Implementazione
public function get fixed():Boolean public function set fixed(value:Boolean):voidlength | proprietà |
length:uint| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
L'intervallo di posizioni di indice valide disponibili nel vettore. Un'istanza Vector dispone di posizioni di indice fino al valore length escluso.
Ogni elemento del vettore ha sempre un valore che corrisponde a un'istanza del tipo di base oppure null. Quando la proprietà length è impostata su un valore maggiore del suo valore precedente, vengono creati elementi aggiuntivi in cui viene inserito il valore predefinito appropriato al tipo di base (null per i tipi di dati di riferimento).
Quando la proprietà length è impostata su un valore minore del suo valore precedente, tutti gli elementi nelle posizioni di indice maggiori di o uguali al nuovo valore length vengono rimossi dal vettore.
Implementazione
public function get length():uint public function set length(value:uint):voidGenera
RangeError — Se questa proprietà viene modificata mentre fixed è true.
| |
RangeError — Se questa proprietà è impostata su un valore maggiore dell'indice massimo consentito (232).
|
Vector | () | Funzione di costruzione |
public function Vector(length:uint = 0, fixed:Boolean = false)| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Crea un vettore con il tipo di base specificato.
Quando chiamate la funzione di costruzione Vector.<T>(), specificate il tipo di base utilizzando la sintassi del parametro type. La sintassi del parametro type è una sequenza formata da un punto (.), parentesi angolare sinistra (<), nome della classe, quindi parentesi angolare destra (>), come nell'esempio seguente:
var v:Vector.<String> = new Vector.<String>();
Per creare un'istanza Vector da un array o da un altro vettore (ad esempio con un diverso tipo di base), utilizzate la funzione globale Vector().
Per creare un'istanza Vector precompilata, utilizzate la seguente sintassi anziché i parametri specificati di seguito:
// var v:Vector.<T> = new <T>[E0, ..., En-1 ,];
// For example:
var v:Vector.<int> = new <int>[0,1,2,];
Le seguenti informazioni si applicano a questa sintassi:
- È supportata in Flash Professional CS5 e versioni successive, in Flash Builder 4 e versioni successive e in Flex 4 e versioni successive.
- La virgola finale è facoltativa.
- Nell'array non sono supportati elementi vuoti; un'istruzione come
var v:Vector.<int> = new <int>[0,,2,]genera un errore del compilatore. - Non potete specificare una lunghezza predefinita per l'istanza Vector. La lunghezza sarà invece la stessa del numero di elementi presenti nell'elenco di inizializzazione.
- Non potete specificare una lunghezza fissa per l'istanza Vector. Utilizzate invece la proprietà
fixed. - Se gli elementi passati come valori non corrispondono al tipo specificato, potrebbero verificarsi errori o una perdita di dati. Ad esempio:
var v:Vector.<int> = new <int>[4.2]; // compiler error when running in strict mode
trace(v[0]); //returns 4 when not running in strict mode
length:uint (default = 0)null per i tipi di dati di riferimento).
| |
fixed:Boolean (default = false)true) o se può essere modificata (false). Questo valore può anche essere impostato utilizzando la proprietà fixed.
|
Elementi API correlati
concat | () | metodo |
AS3 function concat(... args):Vector.<T>| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Concatena i vettori specificati nell'elenco dei parametri con gli elementi di questo vettore e crea un nuovo vettore. I vettori dell'elenco dei parametri devono avere lo stesso tipo di base o sottotipo di questo vettore. Se non passate alcun parametro, il vettore restituito è un duplicato (shallow clone) del vettore originale.
Parametri
... args — Zero o più vettori del tipo di base, o del sottotipo, di questo vettore.
|
Vector.<T> — Un vettore con lo stesso tipo di base di questo vettore che contiene gli elementi di questo vettore seguiti dagli elementi dei vettori dell'elenco dei parametri.
|
Genera
TypeError — Se un argomento qualsiasi non è un vettore del tipo di base o non può essere convertito in un vettore del tipo di base.
|
Altri esempi
every | () | metodo |
AS3 function every(callback:Function, thisObject:Object = null):Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Esegue una funzione di prova su ciascun elemento del vettore fino a quando non viene raggiunto un elemento che restituisce false per la funzione specificata. Potete utilizzare questo metodo per determinare se tutti gli elementi di un vettore soddisfano un criterio, ad esempio se contengono valori inferiori a un determinato numero.
Per questo metodo, il secondo parametro thisObject deve essere null se il primo parametro callback è la chiusura di un metodo. Questo è il modo più comune di utilizzare questo metodo.
Supponete tuttavia di creare una funzione su un fotogramma della linea temporale utilizzando Flash Professional, ma di voler fare in modo che venga chiamata in un contesto this diverso:
function myFunction(item:T, index:int, vector:Vector.<T>):Boolean {
// your code here
}
Supponete quindi di utilizzare il metodo every() su un vettore di nome myVector:
myVector.every(myFunction, someObject);
Poiché myFunction è un membro della classe principale del file SWF, non può essere eseguita in un contesto this diverso. I runtime Flash generano un'eccezione quando questo codice viene eseguito. Questo errore di runtime può essere evitato assegnando la funzione a una variabile, come illustrato di seguito:
var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
//your code here
};
myVector.every(myFunction, someObject);
Parametri
callback:Function — La funzione da eseguire su ciascun elemento nel vettore. Questa funzione viene richiamata con tre argomenti: l'elemento corrente dal vettore, la posizione di indice dell'elemento e l'oggetto Vector:
function callback(item:T, index:int, vector:Vector.<T>):Boolean {
// your code here
}
La funzione di callback dovrebbe restituire un valore booleano. | |
thisObject:Object (default = null)this nella funzione di callback quando si chiama la funzione.
|
Boolean — Un valore booleano true se la funzione specificata restituisce true quando viene chiamata su tutti gli elementi del vettore; altrimenti false.
|
Elementi API correlati
filter | () | metodo |
AS3 function filter(callback:Function, thisObject:Object = null):Vector.<T>| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Esegue una funzione di prova su ciascun elemento del vettore e restituisce un nuovo vettore contenente tutti gli elementi che restituiscono true per la funzione specificata. Se un elemento restituisce false, non viene incluso nel vettore risultante. Il tipo di base del vettore restituito corrisponde al tipo di base del vettore su cui viene chiamato il metodo.
Per questo metodo, il secondo parametro thisObject deve essere null se il primo parametro callback è la chiusura di un metodo. Questo è il modo più comune di utilizzare questo metodo.
Supponete tuttavia di creare una funzione su un fotogramma della linea temporale utilizzando Flash Professional, ma di voler fare in modo che venga chiamata in un contesto this diverso:
function myFunction(item:T, index:int, vector:Vector.<T>):Boolean {
// your code here
}
Supponete quindi di utilizzare il metodo filter() su un vettore di nome myVector:
var result:Vector.<T> = myVector.filter(myFunction, someObject);
Poiché myFunction è un membro della classe principale del file SWF, non può essere eseguita in un contesto this diverso. I runtime Flash generano un'eccezione quando questo codice viene eseguito. Questo errore di runtime può essere evitato assegnando la funzione a una variabile, come illustrato di seguito:
var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
//your code here
};
myVector.filter(myFunction, someObject);
Parametri
callback:Function — La funzione da eseguire su ciascun elemento nel vettore. Questa funzione viene richiamata con tre argomenti: l'elemento corrente dal vettore, la posizione di indice dell'elemento e l'oggetto Vector:
function callback(item:T, index:int, vector:Vector.<T>):Boolean; | |
thisObject:Object (default = null)this nella funzione di callback quando si chiama la funzione.
|
Vector.<T> — Un nuovo vettore che contiene tutti gli elementi del vettore originale per cui la funzione callback ha restituito true.
|
Elementi API correlati
forEach | () | metodo |
AS3 function forEach(callback:Function, thisObject:Object = null):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Esegue una funzione su ciascun elemento nel vettore.
Per questo metodo, il secondo parametro thisObject deve essere null se il primo parametro callback è la chiusura di un metodo. Questo è il modo più comune di utilizzare questo metodo.
Supponete tuttavia di creare una funzione su un fotogramma della linea temporale utilizzando Flash Professional, ma di voler fare in modo che venga chiamata in un contesto this diverso:
function myFunction(item:T, index:int, vector:Vector.<T>):void {
// your code here
}
Supponete quindi di utilizzare il metodo forEach() su un vettore di nome myVector:
myVector.forEach(myFunction, someObject);
Poiché myFunction è un membro della classe principale del file SWF, non può essere eseguita in un contesto this diverso. I runtime Flash generano un'eccezione quando questo codice viene eseguito. Questo errore di runtime può essere evitato assegnando la funzione a una variabile, come illustrato di seguito:
var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
//your code here
};
myVector.forEach(myFunction, someObject);
Parametri
callback:Function — La funzione da eseguire su ciascun elemento nel vettore. Questa funzione viene richiamata con tre argomenti: l'elemento corrente dal vettore, la posizione di indice dell'elemento e l'oggetto Vector:
function callback(item:T, index:int, vector:Vector.<T>):void; Qualsiasi valore restituito dalla chiamata di funzione viene eliminato. | |
thisObject:Object (default = null)this nella funzione di callback quando si chiama la funzione.
|
indexOf | () | metodo |
AS3 function indexOf(searchElement:T, fromIndex:int = 0):int| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Cerca un elemento nel vettore e restituisce la posizione di indice dell'elemento. L'elemento viene confrontato con gli elementi del vettore utilizzando l'eguaglianza rigorosa (===).
Parametri
searchElement:T — L'elemento da trovare nel vettore.
| |
fromIndex:int (default = 0)length + fromIndex; ciò significa che la ricerca comincia dagli elementi -fromIndex partendo dalla fine e viene eseguita da quella posizione verso la fine del vettore.
|
int — Una posizione di indice a base zero dell'elemento nel vettore. Se l'argomento searchElement non viene trovato, il valore restituito è -1.
|
Elementi API correlati
insertAt | () | metodo |
AS3 function insertAt(index:int, element:T):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 19, AIR 19 |
Inserite un singolo elemento nel vettore. Questo metodo modifica il vettore senza crearne una copia.
Parametri
index:int — Un numero intero che specifica la posizione nel vettore in cui l’elemento deve essere inserito. Potete utilizzare un numero intero negativo per specificare una posizione relativa alla fine del vettore (ad esempio, -1 è l'ultimo elemento del vettore).
| |
element:T |
Genera
RangeError — Se questo metodo viene chiamato mentre fixed è true.
|
join | () | metodo |
AS3 function join(sep:String = ","):String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Converte in stringhe gli elementi di un vettore, inserisce il separatore specificato tra gli elementi, li concatena e restituisce la stringa risultante. Un vettore nidificato è sempre separato da un virgola (,) e non dal separatore passato dal metodo join().
Parametri
sep:String (default = ",") |
String — Una stringa costituita dagli elementi del vettore convertiti in stringhe e separati dalla stringa specificata.
|
Altri esempi
Elementi API correlati
lastIndexOf | () | metodo |
AS3 function lastIndexOf(searchElement:T, fromIndex:int = 0x7fffffff):int| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Cerca un elemento nel vettore a ritroso, partendo dalla posizione di indice specificata, e restituisce la posizione di indice dell'elemento corrispondente. L'elemento viene confrontato con gli elementi del vettore utilizzando l'eguaglianza rigorosa (===).
Parametri
searchElement:T — L'elemento da trovare nel vettore.
| |
fromIndex:int (default = 0x7fffffff)Se il parametro è negativo, viene gestito come |
int — Una posizione di indice a base zero dell'elemento nel vettore. Se l'argomento searchElement non viene trovato, il valore restituito è -1.
|
Elementi API correlati
map | () | metodo |
AS3 function map(callback:Function, thisObject:Object = null):Vector.<T>| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Esegue una funzione su ciascun elemento nel vettore e restituisce un nuovo vettore di elementi corrispondenti ai risultati della chiamata di funzione eseguita su ciascun elemento di questo vettore. Il vettore risultante ha lo stesso tipo di base e lo stesso valore length del vettore originale. L'elemento in corrispondenza della posizione di indicei nel vettore risultante è il risultato della chiamata all'elemento nella posizione di indice i nel vettore originale.
Per questo metodo, il secondo parametro thisObject deve essere null se il primo parametro callback è la chiusura di un metodo. Questo è il modo più comune di utilizzare questo metodo.
Supponete tuttavia di creare una funzione su un fotogramma della linea temporale utilizzando Flash Professional, ma di voler fare in modo che venga chiamata in un contesto this diverso:
function myFunction(item:Object, index:int, vector:Vector.<T>):T {
// your code here
}
Supponete quindi di utilizzare il metodo map() su un vettore di nome myVector:
myVector.map(myFunction, someObject);
Poiché myFunction è un membro della classe principale del file SWF, non può essere eseguita in un contesto this diverso. I runtime Flash generano un'eccezione quando questo codice viene eseguito. Questo errore di runtime può essere evitato assegnando la funzione a una variabile, come illustrato di seguito:
var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
//your code here
};
myVector.map(myFunction, someObject);
Parametri
callback:Function — La funzione da eseguire su ciascun elemento nel vettore. Questa funzione viene richiamata con tre argomenti: l'elemento corrente dal vettore, la posizione di indice dell'elemento e l'oggetto Vector:
function callback(item:T, index:int, vector:Vector.<T>):T; | |
thisObject:Object (default = null)this nella funzione di callback quando si chiama la funzione.
|
Vector.<T> — Un nuovo vettore che contiene i risultati della chiamata di funzione su ciascun elemento presente in questo vettore. Il vettore risultante ha lo stesso tipo di base e lo stesso valore length dell'originale.
|
Elementi API correlati
pop | () | metodo |
AS3 function pop():T| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Rimuove l'ultimo elemento dal vettore e lo restituisce. Quando viene chiamata questa funzione, la proprietà length del vettore viene diminuita di uno.
T — Il valore dell'ultimo elemento del vettore specificato.
|
Genera
RangeError — Se questo metodo viene chiamato mentre fixed è true.
|
Altri esempi
Elementi API correlati
push | () | metodo |
AS3 function push(... args):uint| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Aggiunge uno o più elementi alla fine del vettore e ne restituisce la nuova lunghezza.
Poiché questa funzione può accettare più argomenti, il tipo di dati degli argomenti non viene controllato in fase di compilazione, anche in modalità rigorosa. Se tuttavia passate un argomento che non è un'istanza del tipo di base, si verifica un'eccezione in fase di runtime.
Parametri
... args — Uno o più valori da aggiungere al vettore.
|
uint — La lunghezza del vettore dopo l'aggiunta dei nuovi elementi.
|
Genera
TypeError — Se un argomento qualsiasi non è un'istanza del tipo di base T del vettore.
| |
RangeError — Se questo metodo viene chiamato mentre fixed è true.
|
Altri esempi
Elementi API correlati
removeAt | () | metodo |
AS3 function removeAt(index:int):T| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 19, AIR 19 |
Rimuovete un singolo elemento dal vettore. Questo metodo modifica il vettore senza crearne una copia.
Parametri
index:int — Un numero intero che specifica l’indice dell’elemento nel vettore da eliminare. Potete utilizzare un numero intero negativo per specificare una posizione relativa alla fine del vettore (ad esempio, -1 è l'ultimo elemento del vettore).
|
T — L’elemento rimosso dal vettore originale.
|
Genera
RangeError — Se l’argomento indice specifica un indice da eliminare esterno ai limiti del vettore.
| |
RangeError — Se questo metodo viene chiamato mentre fixed è true.
|
reverse | () | metodo |
AS3 function reverse():Vector.<T>| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Inverte l'ordine degli elementi nel vettore. Questo metodo altera il vettore su cui viene chiamato.
RestituisceVector.<T> — Il vettore con gli elementi in ordine inverso.
|
Altri esempi
shift | () | metodo |
AS3 function shift():T| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Rimuove il primo elemento dal vettore e lo restituisce. Gli elementi rimanenti del vettore vengono spostati dalla posizione originale i a i - 1.
RestituisceT — Il primo elemento nel vettore.
|
Genera
RangeError — Se fixed è true.
|
Altri esempi
Elementi API correlati
slice | () | metodo |
AS3 function slice(startIndex:int = 0, endIndex:int = 16777215):Vector.<T>| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Restituisce un nuovo vettore composto da un intervallo di elementi del vettore originale, senza modificare quest'ultimo. Il vettore restituito comprende l'elemento startIndex e tutti gli elementi fino a endIndex escluso.
Se non passate alcun parametro, il nuovo vettore è un duplicato (shallow clone) del vettore originale. Se passate un valore 0 per entrambi i parametri, viene creato un nuovo vettore vuoto con lo stesso tipo del vettore originale.
Parametri
startIndex:int (default = 0)startIndex è un numero negativo, il punto iniziale comincia alla fine del vettore, dove -1 è l'ultimo elemento.
| |
endIndex:int (default = 16777215)endIndex è un numero negativo, il punto finale viene specificato dalla fine del vettore, dove -1 è l'ultimo elemento.
|
Vector.<T> — Un vettore composto da un intervallo di elementi del vettore originale.
|
Altri esempi
some | () | metodo |
AS3 function some(callback:Function, thisObject:Object = null):Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Esegue una funzione di prova su ciascun elemento del vettore fino a quando non viene raggiunto un elemento che restituisce true. Potete utilizzare questo metodo per determinare se tutti gli elementi di un vettore soddisfano un criterio, ad esempio se contengono valori inferiori a un determinato numero.
Per questo metodo, il secondo parametro thisObject deve essere null se il primo parametro callback è la chiusura di un metodo. Questo è il modo più comune di utilizzare questo metodo.
Supponete tuttavia di creare una funzione su un fotogramma della linea temporale, ma di voler fare in modo che venga chiamata in un contesto this diverso:
function myFunction(item:Object, index:int, vector:Vector.<T>):Boolean {
// your code here
}
Supponete quindi di utilizzare il metodo some() su un vettore di nome myVector:
myVector.some(myFunction, someObject);
Poiché myFunction è un membro della classe principale del file SWF, non può essere eseguita in un contesto this diverso. I runtime Flash generano un'eccezione quando questo codice viene eseguito. Questo errore di runtime può essere evitato assegnando la funzione a una variabile, come illustrato di seguito:
var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
//your code here
};
myVector.some(myFunction, someObject);
Parametri
callback:Function — La funzione da eseguire su ciascun elemento nel vettore. Questa funzione viene richiamata con tre argomenti: l'elemento corrente dal vettore, la posizione di indice dell'elemento e l'oggetto Vector:
function callback(item:T, index:int, vector:Vector.<T>):Boolean La funzione di callback dovrebbe restituire un valore booleano. | |
thisObject:Object (default = null)this nella funzione di callback quando si chiama la funzione.
|
Boolean — Un valore booleano true se uno qualunque degli elementi nel vettore restituisce true per la funzione specificata; in caso contrario, false.
|
Elementi API correlati
sort | () | metodo |
AS3 function sort(sortBehavior:*):Vector.<T>| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Ordina gli elementi nell'oggetto Vector e inoltre restituisce un oggetto Vector ordinato. Questo metodo esegue l'ordinamento in base al parametro sortBehavior, che può essere una funzione che confronta due valori o una serie di opzioni di ordinamento.
Il metodo accetta un solo parametro. Il parametro può essere uno dei seguenti:
- una funzione che accetta due argomenti del tipo base (
T) dell'oggetto Vector e restituisce un valore Number:function compare(x:T, y:T):Number {}Secondo la logica della funzione, dati due elementi
xey, la funzione restituisce uno dei seguenti tre valori:- un numero negativo, se
xdeve comparire prima diynella sequenza ordinata; - 0, se
xè uguale ay; - un numero positivo, se
xdeve comparire dopoynella sequenza ordinata.
- un numero negativo, se
- un numero che può essere un OR bit a bit oppure uno dei valori seguenti:
- 1 o
Array.CASEINSENSITIVE - 2 o
Array.DESCENDING - 4 o
Array.UNIQUESORT - 8 o
Array.RETURNINDEXEDARRAY - 16 o
Array.NUMERIC
Se il valore è 0, l'ordinamento si comporta nel modo seguente:
- L'ordinamento fa distinzione tra maiuscole e minuscole (quindi, ad esempio Z precede a).
- L'ordinamento è ascendente (quindi, ad esempio a precede b).
- L'array viene modificato in modo che rispecchi l'ordinamento; gli eventuali elementi multipli che hanno campi di ordinamento identici vengono posizionati in modo consecutivo senza un ordine particolare.
- Tutti gli elementi, a prescindere dal tipo di dati, vengono ordinati come se fossero stringhe, quindi 100 precede 99, perché "1" è un valore di stringa inferiore a "9".
- 1 o
Parametri
sortBehavior:* — Un parametro Function o un valore Number che determina il comportamento dell'ordinamento. Un parametro Function specifica un metodo di comparazione. Un valore Number specifica le opzioni di ordinamento.
|
Vector.<T> — Un oggetto Vector, con gli elementi nel nuovo ordine.
|
Altri esempi
Elementi API correlati
splice | () | metodo |
AS3 function splice(startIndex:int, deleteCount:uint = 4294967295, ... items):Vector.<T>| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Aggiunge e rimuove gli elementi di del vettore. Questo metodo modifica il vettore senza crearne una copia.
Nota: per ignorare questo metodo in una sottoclasse di Vector, utilizzate ...args per i parametri, come illustrato nell'esempio seguente:
public override function splice(...args) {
// your statements here
}
Parametri
startIndex:int — Un numero intero che specifica l'indice dell'elemento nel vettore in cui inizia l'inserimento o l'eliminazione. Potete utilizzare un numero intero negativo per specificare una posizione relativa alla fine del vettore (ad esempio, -1 è l'ultimo elemento del vettore).
| |
deleteCount:uint (default = 4294967295)startIndex. Se il valore è 0, non viene eliminato alcun elemento.
| |
... items — Un elenco opzionale di uno o più valori separati da virgole da inserire nel vettore nella posizione specificata nel parametro startIndex.
|
Vector.<T> — Un vettore che contiene gli elementi che sono stati rimossi dal vettore originale.
|
Genera
RangeError — Se gli argomenti startIndex e deleteCount specificano una posizione di indice da eliminare che si trova all'esterno dei limiti del vettore.
| |
RangeError — Se questo metodo viene chiamata mentre fixed è true e l'operazione splice() modifica l'elemento length del vettore.
|
Altri esempi
toLocaleString | () | metodo |
public function toLocaleString():String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Restituisce una stringa che rappresenta gli elementi nel vettore specificato. Ogni elemento del vettore, a partire dall'elemento con la posizione di indice 0 fino all'elemento con la posizione di indice più alta, viene convertito in una stringa concatenata e separato da virgole. Nell'implementazione ActionScript 3.0, questo metodo restituisce lo stesso valore del metodo Vector.toString().
String — Una stringa di elementi del vettore.
|
Elementi API correlati
toString | () | metodo |
public function toString():String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Restituisce una stringa che rappresenta gli elementi nel vettore. Ogni elemento del vettore, a partire dall'elemento con la posizione di indice 0 fino all'elemento con la posizione di indice più alta, viene convertito in una stringa concatenata e separato da virgole. Per specificare un separatore personalizzato, utilizzate il metodo Vector.join().
String — Una stringa di elementi del vettore.
|
Altri esempi
Elementi API correlati
unshift | () | metodo |
AS3 function unshift(... args):uint| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Aggiunge uno o più elementi all'inizio del vettore e ne restituisce la nuova lunghezza. Gli altri elementi nel vettore vengono spostati dalla posizione originale i a i + numero dei nuovi elementi.
Poiché questa funzione può accettare più argomenti, il tipo di dati degli argomenti non viene controllato in fase di compilazione, anche in modalità rigorosa. Se tuttavia passate un argomento che non è un'istanza del tipo di base, si verifica un'eccezione in fase di runtime.
Parametri
... args — Una o più istanze del tipo di base del vettore da inserire all'inizio del vettore.
|
uint — Un numero intero che rappresenta la nuova lunghezza del vettore.
|
Genera
TypeError — Se un argomento qualsiasi non è un'istanza del tipo di base T del vettore.
| |
RangeError — Se questo metodo viene chiamato mentre fixed è true.
|
Altri esempi
Elementi API correlati
Tue Jun 12 2018, 02:44 PM Z