Vector  - AS3

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 a splice() modifica il valore length del vettore).

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.

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
     

Elementi API correlati

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

Altri esempi

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

function callback(item:T, index:int, vector:Vector.<T>):Boolean {
       // your code here
    }
    

Elementi API correlati

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

function callback(item:T, index:int, vector:Vector.<T>):Boolean;

Elementi API correlati

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

function callback(item:T, index:int, vector:Vector.<T>):void;

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

Elementi API correlati

Inserite un singolo elemento nel vettore. Questo metodo modifica il vettore senza crearne una copia.

Parametri

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

Altri esempi

Elementi API correlati

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

Elementi API correlati

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

function callback(item:T, index:int, vector:Vector.<T>):T;

Elementi API correlati

Rimuove l'ultimo elemento dal vettore e lo restituisce. Quando viene chiamata questa funzione, la proprietà length del vettore viene diminuita di uno.

Altri esempi

Elementi API correlati

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

Altri esempi

Elementi API correlati

Rimuovete un singolo elemento dal vettore. Questo metodo modifica il vettore senza crearne una copia.

Parametri

Inverte l'ordine degli elementi nel vettore. Questo metodo altera il vettore su cui viene chiamato.

Altri esempi

Rimuove il primo elemento dal vettore e lo restituisce. Gli elementi rimanenti del vettore vengono spostati dalla posizione originale i a i - 1.

Altri esempi

Elementi API correlati

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

Altri esempi

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

function callback(item:T, index:int, vector:Vector.<T>):Boolean

Elementi API correlati

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 x e y, la funzione restituisce uno dei seguenti tre valori:

  • un numero negativo, se x deve comparire prima di y nella sequenza ordinata;
  • 0, se x è uguale a y;
  • un numero positivo, se x deve comparire dopo y nella sequenza ordinata.

• 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".

Parametri

Altri esempi

Elementi API correlati

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

Altri esempi

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().

Elementi API correlati

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().

Altri esempi

Elementi API correlati

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

Altri esempi

Elementi API correlati