Vector  - AS3

Anger huruvida length-egenskapen hos Vector kan ändras. Om värdet är true kan length-egenskapen inte ändras. Detta innebär att följande åtgärder inte är tillåtna om fixed är true:

• ställa in lenght-egenskapen direkt
• tilldela indexpositionen length ett värde
• anropa en metod som ändrar length-egenskapen, däribland:
  • pop()
  • push()
  • shift()
  • unshift()
  • splice() (om splice()-anropet ändrar length-egenskapen hos Vector).

Spannet av giltiga indexvärden som finns i Vector. En Vector-instans har indexpositioner upp till, men inte inklusive, length-värdet.

Varje Vector-element har alltid ett värde som är antingen en instans av bastypen eller null. Om length-egenskapen är satt till ett värde som är större än dess tidigare värde skapas och fylls ytterligare element med det standardvärde som är lämpligt för bastypen (null för referenstyper).

Om length-egenskapen är satt till ett värde som är mindre än dess tidigare värde tas alla element vid indexpositioner som är större än eller lika med det nya length-värdet bort från Vector.

Skapar en Vector med den angivna bastypen.

När du anropar Vector.<T>()-konstruktorn anger bastypen med typparametersyntax. Typparametersyntax är en sekvens som består av en punkt (.), vänster vinkelparentes (<), ett klassnamn och därefter höger vinkelparentes (>), som i följande exempel:

     var v:Vector.<String> = new Vector.<String>();
     

Om du vill skapa en Vector-instans från en Array eller en annan Vector (till exempel en med en annan bastyp) använder du den globala Vector-funktionen.

Om du vill skapa en färdigifylld Vector-instans använder du följande syntax i stället för de parametrar som anges nedan:

     // var v:Vector.<T> = new <T>[E0, ..., En-1 ,];
     // For example: 
     var v:Vector.<int> = new <int>[0,1,2,];
     

Följande information gäller den här syntaxen:

• Den stöds i Flash Professional CS5, Flash Builder 4, Flex 4 och senare versioner av alla dessa program.
• Det efterföljande kommat är valfritt.
• Tomma objekt i arrayen stöds inte. En sats som var v:Vector.<int> = new <int>[0,,2,] genererar ett kompileringsfel.
• Du kan inte ange någon standardlängd för Vector-instansen. Längden är i stället samma som antalet element i initieringslistan.
• Du kan inte ange om Vector-instansen ska ha en fast längd. Använd i stället egenskapen fixed.
• Dataförlust eller datafel kan inträffa om objekt som skickas som värden inte matchar den angivna typen. Till exempel:

     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
     

Relaterade API-element

Sammanfogar de vektorer som anges i parameterlistan med elementen i denna Vector och skapar en ny Vector. Vektorer i parameterlistan måste ha samma bastyp, eller undertyp, som denna Vector. Om inga parametrar skickas skapas en kopia (grund klon) av den ursprungliga vektorn.

Parametrar

Kör en testfunktion för varje objekt i Vector tills ett objekt som returnerar false för den angivna funktionen påträffas. Du kan använda denna metod om du vill avgöra om alla objekt i en Vector uppfyller vissa kriterier, till exempel att värdena är mindre än ett visst tal.

I den här metoden måste den andra parametern, thisObject, vara null om den första parametern, callback, är ett metodslut. Det är det vanligaste sättet att använda metoden.

Anta däremot att du skapar en funktion i en bildruta på huvudtidslinjen med Flash Professional, men vill att den ska anropas i en annan this-kontext:

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

Anta sedan att du använder metoden every() på en Vector med namnet myVector:

    myVector.every(myFunction, someObject);
    

Eftersom myFunction tillhör huvudklassen i SWF-filen kan den inte köras i en annan this-kontext. Flash-miljöer genererar ett undantag när den här koden körs. Du kan undvika det här körtidsfelet genom att tilldela funktionen till en variabel enligt följande:

    var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
        //your code here
    };
    myVector.every(myFunction, someObject);
    

Parametrar

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

Relaterade API-element

Kör en testfunktion för varje objekt i Vector och returnerar en ny Vector som innehåller alla objekt som returnerar true för den angivna funktionen. Om ett objekt returnerar false tas det inte med i den nya Vector. Bastypen för retur-Vector överensstämmer med bastypen för den Vector som metoden anropar.

I den här metoden måste den andra parametern, thisObject, vara null om den första parametern, callback, är ett metodslut. Det är det vanligaste sättet att använda metoden.

Anta däremot att du skapar en funktion i en bildruta på huvudtidslinjen med Flash Professional, men vill att den ska anropas i en annan this-kontext:

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

Anta sedan att du använder metoden filter() på en Vector med namnet myVector:

     var result:Vector.<T> = myVector.filter(myFunction, someObject);
     

Eftersom myFunction tillhör huvudklassen i SWF-filen kan den inte köras i en annan this-kontext. Flash-miljöer genererar ett undantag när den här koden körs. Du kan undvika det här körtidsfelet genom att tilldela funktionen till en variabel enligt följande:

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
         //your code here
     };
     myVector.filter(myFunction, someObject);
     

Parametrar

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

Relaterade API-element

Kör en funktion för varje objekt i Vector.

I den här metoden måste den andra parametern, thisObject, vara null om den första parametern, callback, är ett metodslut. Det är det vanligaste sättet att använda metoden.

Anta däremot att du skapar en funktion i en bildruta på huvudtidslinjen med Flash Professional, men vill att den ska anropas i en annan this-kontext:

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

Anta sedan att du använder metoden forEach() på en Vector med namnet myVector:

     myVector.forEach(myFunction, someObject);
     

Eftersom myFunction tillhör huvudklassen i SWF-filen kan den inte köras i en annan this-kontext. Flash-miljöer genererar ett undantag när den här koden körs. Du kan undvika det här körtidsfelet genom att tilldela funktionen till en variabel enligt följande:

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
         //your code here
     };
     myVector.forEach(myFunction, someObject);
     

Parametrar

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

Söker efter ett objekt i Vector och returnerar objektets indexposition. Objektet jämförs med Vector-elementen med strikt likhet (===).

Parametrar

Relaterade API-element

Infoga ett enskilt element i vektorn. Den här metoden ändrar Vector utan att skapa en kopia.

Parametrar

Konverterar elementen i en Vector till strängar, infogar den angivna avgränsaren mellan elementen, sammanfogar dem och returnerar resultatsträngen. En inkapslad Vector avgränsas alltid av ett kommatecken (,), inte av den avgränsare som skickas till metoden join().

Parametrar

Relaterade API-element

Söker efter ett objekt i Vector bakifrån från den angivna indexpositionen och returnerar indexpositionen för det matchande objektet. Objektet jämförs med Vector-elementen med strikt likhet (===).

Parametrar

Relaterade API-element

Kör en funktion på varje objekt i Vector och returnerar en ny Vector med objekt som motsvarar resultatet av att anropa funktionen för varje objekt i denna Vector. Resultat-Vector har samma bastyp och length som ursprungs-Vector. Elementet vid indexpostion i i resultat-Vector är resultatet av anropet på elementet vid indexposition i i ursprungs-Vector.

I den här metoden måste den andra parametern, thisObject, vara null om den första parametern, callback, är ett metodslut. Det är det vanligaste sättet att använda metoden.

Anta däremot att du skapar en funktion i en bildruta på huvudtidslinjen med Flash Professional, men vill att den ska anropas i en annan this-kontext:

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

Anta sedan att du använder metoden map() på en Vector med namnet myVector:

     myVector.map(myFunction, someObject);
     

Eftersom myFunction tillhör huvudklassen i SWF-filen kan den inte köras i en annan this-kontext. Flash-miljöer genererar ett undantag när den här koden körs. Du kan undvika det här körtidsfelet genom att tilldela funktionen till en variabel enligt följande:

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
         //your code here
     };
     myVector.map(myFunction, someObject);
     

Parametrar

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

Relaterade API-element

Tar bort det sista elementet från Vector och returnerar det elementet. length-egenskapen hos Vector minskar med ett när denna funktion anropas.

Relaterade API-element

Lägger till ett eller flera element i slutet av Vector och returnerar dess nya längd.

Eftersom denna funktion kan godkänna flera argument kontrolleras inte argumentens datatyp vid kompilering, inte heller i strikt läge. Om ett argument som inte är en instans av bastypen skickas inträffar dock ett undantag vid körningen.

Parametrar

Relaterade API-element

Ta bort ett enskilt element från vektorn. Den här metoden ändrar Vector utan att skapa en kopia.

Parametrar

Kastar om ordningen på elementen i Vector. Denna metod ändrar den Vector för vilken den anropas.

Tar bort det första elementet från Vector och returnerar det elementet. De resterande Vector-elementen flyttas från sin ursprungliga position, i, till i - 1.

Relaterade API-element

Returnerar en ny Vector som består av ett elementintervall från ursprungs-Vector, utan att den senare ändras. Den returnerade Vector innehåller elementet startIndex och alla element fram till, men inte inklusive, elementet endIndex.

Om inga parametrar skickas skapas en kopia (grund klon) av den ursprungliga vektorn. Om du skickar värdet 0 för båda parametrarna skapas en ny, tom Vector med samma typ som den ursprungliga.

Parametrar

Kör en testfunktion för varje objekt i Vector tills ett objekt som returnerar true påträffas. Använd denna metod om du vill avgöra om något objekt i en Vector uppfyller vissa kriterier, till exempel har ett värde som är mindre än ett visst tal.

I den här metoden måste den andra parametern, thisObject, vara null om den första parametern, callback, är ett metodslut. Det är det vanligaste sättet att använda metoden.

Anta däremot att du skapar en funktion på en bildruta på huvudtidslinjen, men vill att den ska anropas i en annan this-kontext.

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

Anta sedan att du använder metoden some() på en Vector med namnet myVector:

     myVector.some(myFunction, someObject);
     

Eftersom myFunction tillhör huvudklassen i SWF-filen kan den inte köras i en annan this-kontext. Flash-miljöer genererar ett undantag när den här koden körs. Du kan undvika det här körtidsfelet genom att tilldela funktionen till en variabel enligt följande:

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
         //your code here
     };
     myVector.some(myFunction, someObject);
     

Parametrar

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

Relaterade API-element

Sorterar elementen i Vector-objektet och returnerar ett sorterat Vector-objekt. Denna metod sorterar enligt parametern sortBehavior, som antingen är en funktion som jämför två värden eller en uppsättning sorteringsalternativ.

Metoden har två parametrar: Parametern är någon av följande:

• en funktion som tar två argument för bastypen (T) för vektorn och returnerar ett tal:

  function compare(x:T, y:T):Number {}

  Funktionens logik är, given de två elementen x och y, att den returnerar ett av följande tre värden:

  • ett negativt tal, om x skulle finnas före y i den sorterade sekvensen
  • 0, om x är lika med y
  • ett positivt tal, om x skulle finnas efter y i den sorterade sekvensen

• ett tal som är ett binärt OR med följande värden:
  • 1 eller Array.CASEINSENSITIVE
  • 2 eller Array.DESCENDING
  • 4 eller Array.UNIQUESORT
  • 8 eller Array.RETURNINDEXEDARRAY
  • 16 eller Array.NUMERIC

  Om värdet är 0 kommer sorteringen att fungera enligt följande:

  • Sortering är skiftlägeskänslig (Z kommer före a).
  • Sortering är stigande (a kommer före b).
  • Arrayen ändras så att den återger sorteringsordningen. Flera element med samma sorteringsfält placeras efter varandra utan inbördes ordning i den sorterade arrayen.
  • Alla fält, oavsett datatyp, sorteras som om de vore strängar. 100 kommer före 99 eftersom "1" är ett lägre strängvärde än "9".

Parametrar

Relaterade API-element

Lägger till element i, och tar bort element från, en Vector. Den här metoden ändrar Vector utan att skapa en kopia.

Obs!Om du vill åsidosätta den här metoden i en underklass till Vector använder du ...args för parametrarna enligt följande exempel:

     public override function splice(...args) {
       // your statements here
     }
     

Parametrar

Returnerar en sträng som representerar elementen i den angivna Vector. Alla element i Vector, från index 0 till det högsta indexvärdet, konverteras till en sammansatt sträng och avgränsas med kommatecken. I implementeringen av ActionScript 3.0 returnerar den här metoden samma värde som metoden Vector.toString().

Relaterade API-element

Returnerar en sträng som representerar elementen i Vector. Alla element i Vector, från index 0 till det högsta indexvärdet, konverteras till en sammansatt sträng och avgränsas med kommatecken. Om du vill använda en egen avgränsare använder du metoden Vector.join().

Relaterade API-element

Lägger till ett eller flera element i början av Vector och returnerar dess nya längd. De andra elementen i Vector flyttas från sin ursprungsposition, i, till i + antalet nya element.

Eftersom denna funktion kan godkänna flera argument kontrolleras inte argumentens datatyp vid kompilering, inte heller i strikt läge. Om ett argument som inte är en instans av bastypen skickas inträffar dock ett undantag vid körningen.

Parametrar

Relaterade API-element