Vector

Paket	Översta nivån
Klass	public dynamic class Vector
Arv	Vector Object

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

Med klassen Vector kan du använda och ändra en vektor — en array vars element alla har samma datatyp. Datatypen för en element tillhörande en Vector kallas dess bastyp. Bastypen kan vara av vilken klass som helst, även inbyggd eller egen klass. Bastypen anges när en Vector-variabel deklareras, samt när en instans skapas genom att klassens konstruktor anropas.

Precis som med en array kan du använda ([])-operatorn för arrayåtkomst för att ange eller hämta värdet för ett Vector-element. Flera Vectormetoder innehåller också mekanismer för att ange och hämta elementvärden. Bland dessa finns push(), pop(), shift(), unshift(), med flera. Ett Vector-objekts egenskaper och metoder liknar, och är i vissa fall identiska med, egenskaper och metoder för en array. I de flesta fall där du skulle kunna använda en array vars element är av samma datatyp, är en Vector-instans att föredra. Eftersom Vector-instanser är täta arrayer måste den emellertid ha ett värde (eller vara null) i varje index. Array-instanser har inte den här begränsningen.

Bastypen för en Vector anges med postfix-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:

På exemplets första rad deklareras variabelnv som en Vector.<String>-instans. Den representerar med andra ord en Vector (en array) som endast kan innehålla String-instanser och varifrån endast String-instanser kan hämtas. Den andra raden konstruerar en instans av samma Vectortyp (det vill säga en Vector vars element alla är String-objekt) som tilldelas v.

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

En variabel deklarerad med datatypen Vector.<T> kan bara spara en Vector-instans som är konstruerad med samma bastyp T. Exempel: en Vector som har konstruerats genom anrop av new Vector.<String>() kan inte tilldelas en variabel som har deklarerats med datatypen Vector.<int>. Bastyperna måste överensstämma helt. Till exempel kompilerar inte den följande koden eftersom objektets bastyp inte är samma som variabelns deklarerade bastyp (även om Sprite är en underklass till DisplayObject):

 // This code doesn't compile even though Sprite is a DisplayObject subclass
 var v:Vector.<DisplayObject> = new Vector.<Sprite>();

Om du vill konvertera en Vector med bastypen T till en Vector av en superklass till T, använder du den globala Vector()-funktionen.

Förutom datatypsbegränsningen innehåller klassen Vector andra begränsningar som skiljer den från klassen Array:

En Vector är en kompakt array. Till skillnad från en Array, som kan ha indexvärden för 0 och 7 även om inga värden finns på positionerna 1 till 6, måste en Vector ha ett värde (ellernull) för varje index.
En Vector kan ställas in så att den har fast längd, vilket betyder att det antal element den innehåller inte kan ändras.
Åtkomsten till element tillhörande en Vector är avgränsningskontrollerad. Du kan aldrig läsa ett värde från ett index som är större än det sista elementet (length - 1). Du kan aldrig sätta ett värde med ett index större än ett över det aktuella sista indexet (du kan alltså bara sätta ett värde vid ett existerande index eller vid index-[length]).

Tack vare sina begränsningar har en Vector-instans tre viktiga fördelar jämfört med en Array-instans, vars element alla är instanser av en enda klass:

Prestanda: åtkomst och upprepning av arrayelement går mycket snabbare när du använder en Vector-instans än när du använder en Array-instans.
Typsäkerhet: i strikt läge kan kompileraren identifiera datatypfel. Exempel på datatypsfel kan vara att tilldela ett värde med fel datatyp till en vektor eller förvänta fel datatyp när ett värde läses från en Vector-instans. Tänk dock på att argumentens datatyper inte kontrolleras vid kompilering om du använder metoden push() eller unshift() för att lägga till värden i en Vector-instans. De kontrolleras då i stället vid körningen.
Tillförlitlighet: intervallkontroll vid körning (eller kontroll med fast längd) ökar tillförlitligheten avsevärt i jämförelse med arrayer.

Relaterade API-element

[] arrayåtkomst
Vector(), global funktion
Klassen Array

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object
		fixed : Boolean Anger huruvida length-egenskapen hos Vector kan ändras.	Vector
		length : uint Spannet av giltiga indexvärden som finns i Vector.	Vector

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		Vector(length:uint = 0, fixed:Boolean = false) Skapar en Vector med den angivna bastypen.	Vector
		concat(... args):Vector.<T> Sammanfogar de vektorer som anges i parameterlistan med elementen i denna Vector och skapar en ny Vector.	Vector
		every(callback:Function, thisObject:Object = null):Boolean Kör en testfunktion för varje objekt i Vector tills ett objekt som returnerar false för den angivna funktionen påträffas.	Vector
		filter(callback:Function, thisObject:Object = null):Vector.<T> 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.	Vector
		forEach(callback:Function, thisObject:Object = null):void Kör en funktion för varje objekt i Vector.	Vector
		hasOwnProperty(name:String):Boolean Anger om det finns en egenskap angiven för ett objekt.	Object
		indexOf(searchElement:T, fromIndex:int = 0):int Söker efter ett objekt i Vector och returnerar objektets indexposition.	Vector
		insertAt(index:int, element:T):void Infoga ett enskilt element i vektorn.	Vector
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		join(sep:String = ","):String Konverterar elementen i en Vector till strängar, infogar den angivna avgränsaren mellan elementen, sammanfogar dem och returnerar resultatsträngen.	Vector
		lastIndexOf(searchElement:T, fromIndex:int = 0x7fffffff):int Söker efter ett objekt i Vector bakifrån från den angivna indexpositionen och returnerar indexpositionen för det matchande objektet.	Vector
		map(callback:Function, thisObject:Object = null):Vector.<T> 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.	Vector
		pop():T Tar bort det sista elementet från Vector och returnerar det elementet.	Vector
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		push(... args):uint Lägger till ett eller flera element i slutet av Vector och returnerar dess nya längd.	Vector
		removeAt(index:int):T Ta bort ett enskilt element från vektorn.	Vector
		reverse():Vector.<T> Kastar om ordningen på elementen i Vector.	Vector
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		shift():T Tar bort det första elementet från Vector och returnerar det elementet.	Vector
		slice(startIndex:int = 0, endIndex:int = 16777215):Vector.<T> Returnerar en ny Vector som består av ett elementintervall från ursprungs-Vector, utan att den senare ändras.	Vector
		some(callback:Function, thisObject:Object = null):Boolean Kör en testfunktion för varje objekt i Vector tills ett objekt som returnerar true påträffas.	Vector
		sort(sortBehavior:*):Vector.<T> Sorterar elementen i Vector-objektet och returnerar ett sorterat Vector-objekt.	Vector
		splice(startIndex:int, deleteCount:uint = 4294967295, ... items):Vector.<T> Lägger till element i, och tar bort element från, en Vector.	Vector
		toLocaleString():String Returnerar en sträng som representerar elementen i den angivna Vector.	Vector
		toString():String Returnerar en sträng som representerar elementen i Vector.	Vector
		unshift(... args):uint Lägger till ett eller flera element i början av Vector och returnerar dess nya längd.	Vector
		valueOf():Object Returnerar det angivna objektets primitiva värde.	Object

Egenskapsdetaljer

fixed

egenskap

fixed:Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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

Implementering
public function get fixed():Boolean
public function set fixed(value:Boolean):void

length

egenskap

length:uint

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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.

Implementering
public function get length():uint
public function set length(value:uint):void

Utlöser

	`RangeError` — Om denna egenskap ändras när `fixed` är `true`.

	`RangeError` — Om denna egenskap sätts till ett värde som är större än det maximalt tillåtna indexvärdet (2³²).

Konstruktordetaljer

()

Konstruktor

public function Vector(length:uint = 0, fixed:Boolean = false)

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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

Parametrar

	`length:uint` (default = `0`) — Ursprunglig längd (antalet element) hos Vector. Om den här parametern är större än noll skapas och fylls det angivna antalet Vector-element enligt det standardvärde som är lämpligt för bastypen (`null` för referenstyper).

	`fixed:Boolean` (default = `false`) — Huruvida längden hos Vector är fast (`true`) eller kan ändras (`false`). Detta värde kan också sättas med egenskapen `fixed`.

Relaterade API-element

fixed
Vector(), global funktion

Metoddetaljer

concat

()

metod

AS3 function concat(... args):Vector.<T>

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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

... args — Noll eller fler vektorer av bastyp, eller undertyp, för denna Vector.

Returnerar

Vector.<T> — En Vector med samma bastyp som denna Vector, som innehåller elementen från denna Vector följt av elementen från vektorerna i parameterlistan.

Utlöser

TypeError — Om något argument inte är en Vector av bastyp eller inte kan konverteras till en Vector av bastyp.

every

()

metod

AS3 function every(callback:Function, thisObject:Object = null):Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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

callback:Function — Funktionen som ska köras på varje objekt i Vector. Denna funktion anropas med tre argument: det aktuella objektet från Vector, indexvärdet för objektet och Vector-objektet:

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

Callback-funktionen ska returnera ett booleskt värde.

thisObject:Object (default = null) — Det objekt som identifieraren this i callback-funktionen refererar till när funktionen anropas.

Returnerar

Boolean — Ett booleskt true-värde om den angivna funktionen returnerar true när den har anropats i alla objekt i Vector, annars false.

Relaterade API-element

Vector.some()

filter

()

metod

AS3 function filter(callback:Function, thisObject:Object = null):Vector.<T>

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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);

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

Parametrar

	`callback:Function` — Funktionen som ska köras på varje objekt i Vector. Denna funktion anropas med tre argument: det aktuella objektet från Vector, indexvärdet för objektet och Vector-objektet: function callback(item:T, index:int, vector:Vector.<T>):Boolean;

	`thisObject:Object` (default = `null`) — Det objekt som identifieraren `this` i callback-funktionen refererar till när funktionen anropas.

Returnerar

Vector.<T> — En ny Vector som innehåller alla objekt från ursprungs-Vector för vilken callback-funktionen returnerade true.

Relaterade API-element

Vector.map()

forEach

()

metod

AS3 function forEach(callback:Function, thisObject:Object = null):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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);

     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;

Returvärden från funktionsanropet ignoreras.

thisObject:Object (default = null) — Det objekt som identifieraren this i callback-funktionen refererar till när funktionen anropas.

indexOf

()

metod

AS3 function indexOf(searchElement:T, fromIndex:int = 0):int

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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

Parametrar

	`searchElement:T` — Objektet som ska sökas efter i Vector.

	`fromIndex:int` (default = `0`) — Positionen i Vector där sökningen efter objektet ska påbörjas. Om denna parameter är negativ behandlas den som `length + fromIndex`, vilket innebär att sökningen startar `-fromIndex` antal objekt från slutet och söker framåt från den positionen till slutet av Vector.

Returnerar

int — En nollbaserad indexposition för objektet i Vector. Om argumentet searchElement inte hittas returneras -1.

Relaterade API-element

Vector.lastIndexOf()
=== (strikt likhet)

insertAt

()

metod

AS3 function insertAt(index:int, element:T):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 19, AIR 19

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

Parametrar

	`index:int` — Ett heltal som anger positionen i vektorn där elementet ska infogas. Du kan använda ett negativt heltal för att ange en position i förhållande till slutet hos Vector (till exempel -1 för dess sista element).

	`element:T`

Utlöser

RangeError — Om denna metod anropas när fixed är true.

join

()

metod

AS3 function join(sep:String = ","):String

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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

sep:String (default = ",") — Ett tecken eller en sträng som avgränsar Vector-element i den returnerade strängen. Om du inte anger parametern används ett komma som standardavgränsare.

Returnerar

String — En sträng som består av element från en Vector som har konverterats till strängar och som avgränsas av den angivna strängen.

Relaterade API-element

String.split()

lastIndexOf

()

metod

AS3 function lastIndexOf(searchElement:T, fromIndex:int = 0x7fffffff):int

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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

	`searchElement:T` — Objektet som ska sökas efter i Vector.

	`fromIndex:int` (default = `0x7fffffff`) — Positionen i Vector där sökningen efter objektet ska påbörjas. Standardvärdet är det högsta tillåtna indexvärdet, vilket betyder att sökningen startar vid det sista objektet i Vector. Om denna parameter är negativ behandlas den som `length + fromIndex`, vilket innebär att sökningen startar `-fromIndex` antal objekt från slutet och söker bakåt från den positionen till index 0.

Returnerar

int — En nollbaserad indexposition för objektet i Vector. Om argumentet searchElement inte hittas returneras -1.

Relaterade API-element

Vector.indexOf()
=== (strikt likhet)

map

()

metod

AS3 function map(callback:Function, thisObject:Object = null):Vector.<T>

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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);

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

Parametrar

	`callback:Function` — Funktionen som ska köras på varje objekt i Vector. Denna funktion anropas med tre argument: det aktuella objektet från Vector, indexvärdet för objektet och Vector-objektet: function callback(item:T, index:int, vector:Vector.<T>):T;

	`thisObject:Object` (default = `null`) — Det objekt som identifieraren `this` i callback-funktionen refererar till när funktionen anropas.

Returnerar

Vector.<T> — En ny Vector som innehåller resultatet av ett funktionsanrop på varje objekt i Vector. Den nya Vector har samma bastyp och length som ursprungs-Vector.

Relaterade API-element

Vector.filter()

pop

()

metod

AS3 function pop():T

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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

Returnerar

T — Värdet för det sista elementet i angiven Vector.

Utlöser

RangeError — Om denna metod anropas när fixed är true.

Relaterade API-element

Vector.push()
Vector.shift()
Vector.unshift()

push

()

metod

AS3 function push(... args):uint

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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

... args — Ett eller flera värden som bifogas Vector.

Returnerar

uint — Längden hos Vector efter att de nya elementen har lagts till.

Utlöser

	`TypeError` — Om något argument inte är en instans av bastypen `T` hos Vector.

	`RangeError` — Om denna metod anropas när `fixed` är `true`.

Relaterade API-element

Vector.pop()
Vector.shift()
Vector.unshift()

removeAt

()

metod

AS3 function removeAt(index:int):T

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 19, AIR 19

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

Parametrar

index:int — Ett heltal som anger indexvärdet för elementet i vektorn som ska tas bort. Du kan använda ett negativt heltal för att ange en position i förhållande till slutet hos Vector (till exempel -1 för dess sista element).

Returnerar

T — Det element som togs bort från originalvektorn.

Utlöser

	`RangeError` — Om argumentet `index` anger att ett indexvärde som ligger utanför vektorns gränser ska tas bort.

	`RangeError` — Om denna metod anropas när `fixed` är `true`.

reverse

()

metod

AS3 function reverse():Vector.<T>

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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

Returnerar

Vector.<T> — Vector med elementen i omvänd ordning.

shift

()

metod

AS3 function shift():T

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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.

Returnerar

T — Det första elementet i Vector.

Utlöser

RangeError — Om fixed är true.

Relaterade API-element

Vector.pop()
Vector.push()
Vector.unshift()

slice

()

metod

AS3 function slice(startIndex:int = 0, endIndex:int = 16777215):Vector.<T>

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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

	`startIndex:int` (default = `0`) — Ett tal som anger indexvärdet på referenspunkten för segmentet. Om `startIndex` är ett negativt tal börjar startpunkten i slutet av Vector, där -1 är det sista elementet.

	`endIndex:int` (default = `16777215`) — Ett tal som anger indexvärdet på slutpunkten för segmentet. Om du utelämnar den här parametern omfattar segmentet alla element från startpunkten till slutet av Vector. Om `endIndex` är ett negativt tal specificeras slutpunkten från slutet av Vector, där -1 är det sista elementet.

Returnerar

Vector.<T> — en Vector som består av ett elementintervall från ursprungs-Vector.

some

()

metod

AS3 function some(callback:Function, thisObject:Object = null):Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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);

     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

Callback-funktionen ska returnera ett booleskt värde.

thisObject:Object (default = null) — Det objekt som identifieraren this i callback-funktionen refererar till när funktionen anropas.

Returnerar

Boolean — Det booleska värdet true om något objekt i Vector returnerar true för den angivna funktionen; annars false.

Relaterade API-element

every()

sort

()

metod

AS3 function sort(sortBehavior:*):Vector.<T>

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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

sortBehavior:* — Ett Function- eller ett Number-värde som anger hur sorteringen utförs. En Function-parameter anger en jämförelsemetod. Ett Number-värde anger sorteringsalternativen.

Returnerar

Vector.<T> — Ett Vector-objekt, med element i den nya ordningen.

Relaterade API-element

Array.sort()

splice

()

metod

AS3 function splice(startIndex:int, deleteCount:uint = 4294967295, ... items):Vector.<T>

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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

	`startIndex:int` — Ett heltal som anger indexvärdet för elementet i Vector där inmatningen eller borttagningen börjar. Du kan använda ett negativt heltal för att ange en position i förhållande till slutet hos Vector (till exempel -1 för dess sista element).

	`deleteCount:uint` (default = `4294967295`) — Ett heltal som anger hur många element som ska tas bort. Antalet inkluderar det element som anges av parametern `startIndex`. Om värdet är 0 tas inga element bort.

	`... items` — En valfri lista med ett eller flera kommaavgränsade värden som ska infogas i vektorn vid den position som anges av parametern `startIndex`.

Returnerar

Vector.<T> — en Vector som innehåller de element som togs bort från original-Vector.

Utlöser

	`RangeError` — Om argumenten `startIndex` och `deleteCount` anger att ett indexvärde ska tas bort som ligger utanför gränserna för Vector.

	`RangeError` — Anrop av denna metod när `fixed` är `true` och `splice()`-åtgärden ändrar `length` hos Vector.

toLocaleString

()

metod

public function toLocaleString():String

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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

Returnerar

String — En sträng med Vector-element.

Relaterade API-element

Vector.toString()

toString

()

metod

public function toString():String

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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

Returnerar

String — En sträng med Vector-element.

Relaterade API-element

String.split()
Vector.join()

unshift

()

metod

AS3 function unshift(... args):uint

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10, AIR 1.5, Flash Lite 4

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.

Parametrar

... args — En eller flera instanser av bastypen för den Vector som ska infogas i början av Vector.

Returnerar

uint — Ett heltal som representerar den nya längden hos Vector.

Utlöser

	`TypeError` — Om något argument inte är en instans av bastypen `T` hos Vector.

	`RangeError` — Om denna metod anropas när `fixed` är `true`.

Relaterade API-element

Vector.pop()
Vector.push()
Vector.shift()

Juridiska meddelanden | Onlinesekretesspolicy

Vector - AS3

Klasser x

fixed

length

Vector

concat

every

filter

forEach

indexOf

insertAt

join

lastIndexOf

map

pop

push

removeAt

reverse

shift

slice

some

sort

splice

toLocaleString

toString

unshift