Naslaggids voor Adobe ActionScript® 3.0 voor het Adobe® Flash®-platform
Startpagina  |  Lijst met pakketten en klassen verbergen |  Pakketten  |  Klassen  |  Nieuw  |  Index  |  Bijlagen  |  Waarom in het Engels?
Filters: Gegevens ophalen van server...
Gegevens ophalen van server...
Hoofdniveau 

Vector  - AS3

PakketHoofdniveau
Klassepublic dynamic class Vector
OverervingVector Inheritance Object

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Met de klasse Vector kunt u een vector openen en bewerken — een vector is een array waarvan de elementen allemaal hetzelfde gegevenstype hebben. Het gegevenstype van de elementen van een vector is het basistype van de vector. Het basistype kan elke klasse zijn, inclusief ingebouwde klasse en aangepaste klasse. U geeft het basistype op wanneer u een vectorvariabele declareert en wanneer u een instantie maakt door de klasseconstructor aan te roepen.

U kunt, net als met een array, de operator voor arraytoegang ([]) gebruiken om de waarde van een vectorelement op te halen of in te stellen. Verschillende vectormethoden bieden ook methoden voor het instellen en ophalen van elementwaarden. Dit zijn onder andere push(), pop(), shift(), unshift() en overige. De eigenschappen en methoden van een vectorobject zijn vergelijkbaar — in de meeste gevallen zelfs identiek — met de eigenschappen en methoden van een array. In de meeste situaties waarin u een array zou gebruiken waarin alle elementen hetzelfde gegevenstype hebben, heeft een Vector-instantie de voorkeur. De vectorinstanties zijn echter dichte arrays en moeten in elke index een waarde (of null) hebben. Array-instanties hebben deze beperking niet.

Het basistype van een vector wordt opgegeven met een parametersyntaxis van het postfix-type. Type parametersyntaxis is een reeks die bestaat uit een punt (.), linkerpunthaakje (<), klassenaam en rechterpunthaakje (>), zoals in dit voorbeeld:

In de eerste regel van het voorbeeld is de variabele v gedeclareerd als een Vector.<String>-instantie. Met andere woorden, het staat voor een vector (een array) die alleen String-instanties kan bevatten en waaruit alleen String-instanties kunnen worden opgehaald. De tweede regel construeert een instantie van hetzelfde vectortype (een vector waarvan de elementen allemaal String-objecten zijn) en wijst deze toe aan v.

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

Een variabele die is gedeclareerd met het gegevenstype Vector.Het gegevenstype <T> kan alleen een vectorinstantie opslaan die is geconstrueerd met hetzelfde basistype T. Een vector die bijvoorbeeld is geconstrueerd door het aanroepen van nieuwe Vector.<String>(), kan niet aan een variabele worden toegewezen die met de vector is gedeclareerd.<int>-gegevenstype. De basistypen moeten exact overeenkomen. De volgende code zal bijvoorbeeld niet compileren omdat het basistype van het object niet hetzelfde is als het gedeclareerde basistype van de variabele (ook al is Sprite een subklasse van DisplayObject):

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

U kunt een vector met basistype T omzetten in een vector met superklasse T. Hiervoor gebruikt u de algemene functie Vector().

De vectorklasse heeft naast de gegevenstypebeperking ook andere beperkingen die deze van de klasse Array onderscheiden:

  • Een vector is een dichte array. In tegenstelling tot een array, die waarden in index 0 en 7 kan bevatten, ook al zijn er geen waarden op positie 1 tot en met 6, moet een vector in elke index een waarde (of null) bevatten.
  • Een vector kan eventueel een vaste lengte hebben; dit betekent dat het aantal elementen erin onveranderd moet blijven.
  • Toegang tot de elementen van een vector wordt met begrenzingen gecontroleerd. U kunt nooit een waarde uit een index lezen die groter is dan het laatste element (lengte - 1). U kunt nooit een waarde met een index instellen die meer dan één verder ligt dan de huidige laatste index (met andere woorden, u kunt alleen een waarde bij een bestaande index instellen of bij index [lengte]).

Een vector heeft, door zijn beperkingen, drie belangrijke voordelen boven een array-instantie waarvan de elementen allemaal van één klasse zijn:

  • Prestatie: toegang tot en iteratie van arrayelementen zijn veel sneller wanneer u een vector-instantie gebruikt dan met een array.
  • Veiligheid van type: in de strikte modus kan de compiler gegevenstypefouten onderscheppen. Voorbeelden van gegevenstypefouten zijn het toewijzen van een waarde van een verkeerd gegevenstype aan een vector, of het verwachten van het verkeerde gegevenstype wanneer een waarde uit een vector wordt gelezen. Wanneer u echter de methode push() of unshift() gebruikt om waarden aan een vector toe te voegen, worden de gegevenstypen van het argument niet tijdens het compileren gecontroleerd. In plaats daarvan worden ze tijdens de runtime gecontroleerd.
  • Betrouwbaarheid: controle van het runtimebereik (of van een vaste lengte) verhoogt de betrouwbaarheid aanzienlijk vergeleken met Arrays.

Verwante API-elementen



Openbare eigenschappen
 EigenschapGedefinieerd door
 Inheritedconstructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.
Object
  fixed : Boolean
Geeft aan of de eigenschap length van de Vector kan worden gewijzigd.
Vector
  length : uint
Het bereik van geldige indexen die beschikbaar zijn in de Vector.
Vector
Openbare methoden
 MethodeGedefinieerd door
  
Vector(length:uint = 0, fixed:Boolean = false)
Maakt een vector met het opgegeven basistype.
Vector
  
concat(... args):Vector.<T>
Hiermee worden de vectoren die in de parameterlijsten zijn opgegeven, samengevoegd met de elementen in deze vector en wordt een nieuwe vector gemaakt.
Vector
  
every(callback:Function, thisObject:Object = null):Boolean
Hiermee wordt een testfunctie uitgevoerd op elk item in de Vector totdat een item wordt bereikt dat voor de opgegeven functie onwaar retourneert.
Vector
  
filter(callback:Function, thisObject:Object = null):Vector.<T>
Hiermee wordt een testfunctie uitgevoerd voor elk item in de Vector en wordt een nieuwe Vector gemaakt voor alle items die voor de opgegeven functie true retourneren.
Vector
  
forEach(callback:Function, thisObject:Object = null):void
Hiermee wordt een functie uitgevoerd op elk item in de Vector.
Vector
 Inherited
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.
Object
  
indexOf(searchElement:T, fromIndex:int = 0):int
Zoekt een item in de Vector en retourneert de indexpositie van het item.
Vector
  
insertAt(index:int, element:T):void
Voeg een enkel element in de Vector in.
Vector
 Inherited
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.
Object
  
join(sep:String = ","):String
Zet de elementen in een Vector om in tekenreeksen, voegt het opgegeven scheidingsteken in tussen de elementen, voegt de elementen samen en retourneert de resulterende tekenreeks.
Vector
  
lastIndexOf(searchElement:T, fromIndex:int = 0x7fffffff):int
Zoekt een item in de Vector, achterwaarts vanaf de opgegeven indexpositie, en retourneert de indexpositie van het gevonden item.
Vector
  
map(callback:Function, thisObject:Object = null):Vector.<T>
Voert een functie uit op ieder item in de Vector en retourneert een nieuwe Vector met items die overeenkomen met de resultaten van het aanroepen van de functie op elk item in deze Vector.
Vector
  
pop():T
Hiermee wordt het laatste element uit de Vector verwijderd en wordt dit element geretourneerd.
Vector
 Inherited
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.
Object
  
push(... args):uint
Hiermee worden een of meer elementen aan het einde van de Vector toegevoegd en wordt de nieuwe lengte van de Vector geretourneerd.
Vector
  
removeAt(index:int):T
Verwijder een enkel element uit de Vector.
Vector
  
Keert de volgorde van de elementen in de Vector om.
Vector
 Inherited
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.
Object
  
shift():T
Hiermee wordt het eerste element uit de Vector verwijderd en wordt dit element geretourneerd.
Vector
  
slice(startIndex:int = 0, endIndex:int = 16777215):Vector.<T>
Retourneert een nieuwe Vector die bestaat uit een reeks elementen van de oorspronkelijke Vector. De oorspronkelijke Vector wordt niet gewijzigd.
Vector
  
some(callback:Function, thisObject:Object = null):Boolean
Voert een testfunctie uit op elk item in de Vector totdat een item wordt bereikt dat true retourneert.
Vector
  
sort(sortBehavior:*):Vector.<T>
Sorteert de elementen in het Vector-object en retourneert ook een gesorteerd Vector-object.
Vector
  
splice(startIndex:int, deleteCount:uint = 4294967295, ... items):Vector.<T>
Hiermee worden elementen aan de Vector toegevoegd en worden elementen uit de Vector verwijderd.
Vector
  
Retourneert een tekenreeks die de elementen in de opgegeven Vector vertegenwoordigt.
Vector
  
Retourneert een tekenreeks die de elementen in de Vector vertegenwoordigt.
Vector
  
Hiermee worden een of meer elementen aan het begin van de Vector toegevoegd en wordt de nieuwe lengte van de Vector geretourneerd.
Vector
 Inherited
Retourneert de primitieve waarde van het opgegeven object.
Object
Eigenschapdetails

fixed

eigenschap
fixed:Boolean

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Geeft aan of de eigenschap length van de Vector kan worden gewijzigd. Als de waarde true is, kan de eigenschap length niet worden gewijzigd. Dit betekent dat de volgende bewerkingen niet zijn toegestaan als fixed true is:

  • de eigenschap length direct instellen
  • een waarde toewijzen aan indexpositie length
  • een methode aanroepen waarmee de eigenschap length wordt gewijzigd, waaronder:
    • pop()
    • push()
    • shift()
    • unshift()
    • splice() (als de splice()-aanroep de lengte van de Vector wijzigt).



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

length

eigenschap 
length:uint

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Het bereik van geldige indexen die beschikbaar zijn in de Vector. Een Vectorinstantie heeft indexposities tot (niet tot en met) de waarde length.

Elk Vectorelement heeft altijd een waarde die ofwel een instantie van het basistype is ofwel null. Wanneer de eigenschap length is ingesteld op een waarde die groter is dan de vorige waarde, worden extra elementen gemaakt en krijgen deze de standaardwaarde die bij het basistype past (null voor verwijzingstypen).

Wanneer de eigenschap length is ingesteld op een waarde die kleiner is dan de vorige waarde, worden alle elementen op indexposities die groter zijn dan of gelijk zijn aan de nieuwe waarde voor length, uit de Vector verwijderd.



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

Gegenereerde uitzondering
RangeError — Als deze eigenschap wordt gewijzigd terwijl fixed true is.
 
RangeError — Als deze eigenschap is ingesteld op een waarde die groter is dan de maximaal toegestane index (232).
Constructordetails

Vector

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Maakt een vector met het opgegeven basistype.

Bij het aanroepen van de Vector.<T>()-constructor, geef het basistype aan met parametersyntaxis voor type. Type parametersyntaxis is een reeks die bestaat uit een punt (.), linkerpunthaakje (<), klassenaam en rechterpunthaakje (>), zoals in dit voorbeeld:

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

Als u een Vector-instantie wilt maken van een Array of een andere Vector (bijvoorbeeld met een ander basistype), gebruikt u de algemene functie Vector().

Om een vooraf ingevulde vectorinstantie te maken, gebruikt u de volgende syntaxis in plaats van de hieronder beschreven parameters.

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

Op deze syntaxis is de volgende informatie van toepassing:

  • Het wordt ondersteund in Flash Professional CS5 en later, Flash Builder 4 en later en Flex 4 en later.
  • De volgkomma is optioneel.
  • Lege items in de array worden niet ondersteund; een instructie zoals var v:Vector.<int> = new <int>[0,,2,] levert een compilerfout op.
  • U kunt geen standaardlengte opgeven voor de vectorinstantie. In plaats daarvan, is de lengte hetzelfde als het aantal elementen in de initialisatielijst.
  • U kunt niet opgeven of de vectorinstantie een vaste lengte heeft. Gebruik in plaats daarvan gebruikt u de fixed-eigenschap.
  • Gegevensverlies of fouten kunnen optreden als items die als waarden doorgegeven worden, niet overeenkomen met het opgegeven type. Bijvoorbeeld:
  •      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
         

Parameters
length:uint (default = 0) — De oorspronkelijke lengte (aantal elementen) van de vector. Als deze parameter groter is dan nul, wordt het opgegeven aantal vectorelementen gemaakt en wordt de standaardwaarde voor het basistype eraan toegewezen (null voor referentietypen).
 
fixed:Boolean (default = false) — Geeft aan of de lengte van de vector vast is (true) of kan worden gewijzigd (false). U kunt deze waarde ook instellen met de eigenschap fixed.

Verwante API-elementen

Methodedetails

concat

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Hiermee worden de vectoren die in de parameterlijsten zijn opgegeven, samengevoegd met de elementen in deze vector en wordt een nieuwe vector gemaakt. De vectoren in de parameterlijst moeten van hetzelfde basistype (of subtype) zijn als deze vector. Wanneer u geen parameters doorgeeft, is de geretourneerde vector een duplicaat (oppervlakkige kloon) van de oorspronkelijke vector.

Parameters

... args — Nul of meer vectoren van het basistype (of subtype) van deze vector.

Geretourneerde waarde
Vector.<T> — Een vector met hetzelfde basistype als deze vector die de elementen van deze vector bevat, gevolgd door elementen van de vectoren in de parameterlijsten.

Gegenereerde uitzondering
TypeError — Als een argument geen vector is van het basistype, of niet naar een vector van het basistype kan worden geconverteerd.

every

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Voert een testfunctie uit op elk item in de Vector totdat een item wordt bereikt dat voor de opgegeven functie false retourneert. U gebruikt deze methode om vast te stellen of alle items in een Vector aan een criterium voldoen, zoals het hebben van waarden onder een bepaald getal.

Voor deze methode moet de tweede parameter, thisObject, gelijk aan null zijn wanneer de eerste parameter, callback, de methode afsluit. Dat is de meest gebruikelijke toepassing van deze methode.

Stel echter dat u met Flash Professional een functie maakt op een frame in de hoofdtijdlijn, maar deze wilt aanroepen in een andere this-context:

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

Vervolgens gebruikt u de methode every() op een Vector met de naam myVector:

    myVector.every(myFunction, someObject);
    

Omdat myFunction lid is van de hoofdklasse van het SWF-bestand, kan deze niet worden uitgevoerd in een andere this-context. Wanneer deze code wordt uitgevoerd, treedt een uitzonderingsfout op in Flash-runtimes. U kunt deze fout bij uitvoering voorkomen door de functie als volgt toe te wijzen aan een variabele:

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

Parameters

callback:Function — De functie die op elk item in de Vector moet worden uitgevoerd. Deze functie wordt met drie argumenten aangeroepen: het huidige item uit de Vector, de index van het item en het Vector-object:
function callback(item:T, index:int, vector:Vector.<T>):Boolean {
       // your code here
    }
    

De callback-functie moet een Booleaanse waarde retourneren.

 
thisObject:Object (default = null) — Het object waarnaar de identificatie this in de functie callback verwijst wanneer de functie wordt aangeroepen.

Geretourneerde waarde
Boolean — Een booleaanse waarde true als de opgegeven functie true retourneert wanneer deze is aangeroepen op alle items in de Vector; anders false.

Verwante API-elementen

filter

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Hiermee wordt een testfunctie uitgevoerd voor elk item in de Vector en wordt een nieuwe Vector gemaakt met alle items die voor de opgegeven functie true retourneren. Items die false retourneren, worden niet in de nieuwe Vector opgenomen. Het basistype van de geretourneerde Vector komt overeen met het basistype van de Vector waarvoor de methode is aangeroepen.

Voor deze methode moet de tweede parameter, thisObject, gelijk aan null zijn wanneer de eerste parameter, callback, de methode afsluit. Dat is de meest gebruikelijke toepassing van deze methode.

Stel echter dat u met Flash Professional een functie maakt op een frame in de hoofdtijdlijn, maar deze wilt aanroepen in een andere this-context:

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

Vervolgens gebruikt u de methode filter() voor een Vector met de naam myVector:

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

Omdat myFunction lid is van de hoofdklasse van het SWF-bestand, kan deze niet worden uitgevoerd in een andere this-context. Wanneer deze code wordt uitgevoerd, treedt een uitzonderingsfout op in Flash-runtimes. U kunt deze fout bij uitvoering voorkomen door de functie als volgt toe te wijzen aan een variabele:

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

Parameters

callback:Function — De functie die op elk item in de Vector moet worden uitgevoerd. Deze functie wordt met drie argumenten aangeroepen: het huidige item uit de Vector, de index van het item en het Vector-object:
function callback(item:T, index:int, vector:Vector.<T>):Boolean;
 
thisObject:Object (default = null) — Het object waarnaar de identificatie this in de functie callback verwijst wanneer de functie wordt aangeroepen.

Geretourneerde waarde
Vector.<T> — Een nieuwe Vector met alle items van de oorspronkelijke Vector waarvoor de functie callback true retourneerde.

Verwante API-elementen

forEach

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Hiermee wordt een functie uitgevoerd op elk item in de Vector.

Voor deze methode moet de tweede parameter, thisObject, gelijk aan null zijn wanneer de eerste parameter, callback, de methode afsluit. Dat is de meest gebruikelijke toepassing van deze methode.

Stel echter dat u met Flash Professional een functie maakt op een frame in de hoofdtijdlijn, maar deze wilt aanroepen in een andere this-context:

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

Vervolgens gebruikt u de methode forEach() voor een Vector met de naam myVector:

     myVector.forEach(myFunction, someObject);
     

Omdat myFunction lid is van de hoofdklasse van het SWF-bestand, kan deze niet worden uitgevoerd in een andere this-context. Wanneer deze code wordt uitgevoerd, treedt een uitzonderingsfout op in Flash-runtimes. U kunt deze fout bij uitvoering voorkomen door de functie als volgt toe te wijzen aan een variabele:

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

Parameters

callback:Function — De functie die op elk item in de Vector moet worden uitgevoerd. Deze functie wordt met drie argumenten aangeroepen: het huidige item uit de Vector, de index van het item en het Vector-object:
function callback(item:T, index:int, vector:Vector.<T>):void;

Elke geretourneerde waarde van de functieaanroep wordt verwijderd.

 
thisObject:Object (default = null) — Het object waarnaar de identificatie this in de functie callback verwijst wanneer de functie wordt aangeroepen.

indexOf

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Zoekt een item in de Vector en retourneert de indexpositie van het item. Het item wordt vergeleken met de Vector-elementen aan de hand van strikte gelijkheid (===).

Parameters

searchElement:T — Het item dat moet worden gevonden in de Vector.
 
fromIndex:int (default = 0) — De locatie in de Vector waar het zoeken naar het item moet beginnen. Als deze parameter negatief is, wordt deze als length + fromIndex behandeld. Dit betekent dat het zoeken begint in -fromIndex items van het einde en vanaf dat punt vooruit zoekt tot het einde van de Vector.

Geretourneerde waarde
int — Een op nul gebaseerde indexpositie van het item in de Vector. Wanneer het argument searchElement niet wordt gevonden, is de geretourneerde waarde -1.

Verwante API-elementen

insertAt

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 19, AIR 19

Voeg een enkel element in de Vector in. Bij deze methode wordt de Vector gewijzigd zonder dat een kopie wordt gemaakt.

Parameters

index:int — Een geheel getal dat de positie in de Vector aangeeft waar het element wordt ingevoegd. U kunt een negatief geheel getal gebruiken om een positie op te geven ten opzichte van het einde van de Vector (bijvoorbeeld -1 is het laatste element van de Vector).
 
element:T


Gegenereerde uitzondering
RangeError — Als deze methode wordt aangeroepen terwijl fixed true is.

join

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Zet de elementen in een Vector om in tekenreeksen, voegt het opgegeven scheidingsteken in tussen de elementen, voegt de elementen samen en retourneert de resulterende tekenreeks. Een geneste Vector wordt altijd gescheiden door een komma (,) en niet door het scheidingsteken dat aan de methode join() is doorgegeven.

Parameters

sep:String (default = ",") — Een teken of tekenreeks voor het scheiden van Vectorelementen in de geretourneerde tekenreeks. Wanneer u deze parameter weglaat, wordt een komma als standaardscheidingsteken gebruikt.

Geretourneerde waarde
String — Een tekenreeks die bestaat uit de elementen van een Vector die is omgezet in tekenreeksen en gescheiden door de opgegeven tekenreeks.

Verwante API-elementen

lastIndexOf

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Zoekt een item in de Vector, achterwaarts vanaf de opgegeven indexpositie, en retourneert de indexpositie van het gevonden item. Het item wordt vergeleken met de Vector-elementen aan de hand van strikte gelijkheid (===).

Parameters

searchElement:T — Het item dat moet worden gevonden in de Vector.
 
fromIndex:int (default = 0x7fffffff) — De locatie in de Vector waar het zoeken naar het item moet beginnen. De standaardinstelling is de maximaal toegestane indexwaarde; dit betekent dat het zoeken begint bij het laatste item in de Vector.

Als deze parameter negatief is, wordt deze als length + fromIndex behandeld. Dit betekent dat het zoeken begint in -fromIndex items van het einde en vanaf dat punt achterwaarts zoekt tot index 0.

Geretourneerde waarde
int — Een op nul gebaseerde indexpositie van het item in de Vector. Wanneer het argument searchElement niet wordt gevonden, is de geretourneerde waarde -1.

Verwante API-elementen

map

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Voert een functie uit op ieder item in de Vector en retourneert een nieuwe Vector met items die overeenkomen met de resultaten van het aanroepen van de functie op elk item in deze Vector. De resulterende Vector heeft hetzelfde basistype en dezelfde length als de originele Vector. Het element bij index i in de resulterende Vector is het resultaat van de aanroep op het element bij index i in de oorspronkelijkeVector.

Voor deze methode moet de tweede parameter, thisObject, gelijk aan null zijn wanneer de eerste parameter, callback, de methode afsluit. Dat is de meest gebruikelijke toepassing van deze methode.

Stel echter dat u met Flash Professional een functie maakt op een frame in de hoofdtijdlijn, maar deze wilt aanroepen in een andere this-context:

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

Vervolgens gebruikt u de methode map() voor een Vector met de naam myVector:

     myVector.map(myFunction, someObject);
     

Omdat myFunction lid is van de hoofdklasse van het SWF-bestand, kan deze niet worden uitgevoerd in een andere this-context. Wanneer deze code wordt uitgevoerd, treedt een uitzonderingsfout op in Flash-runtimes. U kunt deze fout bij uitvoering voorkomen door de functie als volgt toe te wijzen aan een variabele:

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

Parameters

callback:Function — De functie die op elk item in de Vector moet worden uitgevoerd. Deze functie wordt met drie argumenten aangeroepen: het huidige item uit de Vector, de index van het item en het Vector-object:
function callback(item:T, index:int, vector:Vector.<T>):T;
 
thisObject:Object (default = null) — Het object waarnaar de identificatie this in de functie callback verwijst wanneer de functie wordt aangeroepen.

Geretourneerde waarde
Vector.<T> — Een nieuwe Vector met de resultaten van het aanroepen van de functie op elk item in deze Vector. De resulterende Vector heeft hetzelfde basistype en dezelfde length als het origineel.

Verwante API-elementen

pop

()methode 
AS3 function pop():T

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Hiermee wordt het laatste element uit de Vector verwijderd en wordt dit element geretourneerd. De eigenschap length van de Vector wordt met één verminderd wanneer deze functie wordt aangeroepen.

Geretourneerde waarde
T — De waarde van het laatste element in de opgegeven Vector.

Gegenereerde uitzondering
RangeError — Als deze methode wordt aangeroepen terwijl fixed true is.

Verwante API-elementen

push

()methode 
AS3 function push(... args):uint

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Hiermee worden een of meer elementen aan het einde van de Vector toegevoegd en wordt de nieuwe lengte van de Vector geretourneerd.

Omdat deze functie meerdere argumenten kan bevatten, wordt het gegevenstype van de argumenten zelfs in strikte modus niet gecontroleerd bij de compilatie. Als een argument echter wordt goedgekeurd dat geen instantie is van het basistype, treedt tijdens runtime een uitzonderingsfout op.

Parameters

... args — Eén of meer waarden die aan de Vector kunnen worden toegevoegd.

Geretourneerde waarde
uint — De lengte van de Vector nadat de nieuwe elementen zijn toegevoegd.

Gegenereerde uitzondering
TypeError — Als een argument geen instantie is van het basistype T van de Vector.
 
RangeError — Als deze methode wordt aangeroepen terwijl fixed true is.

Verwante API-elementen

removeAt

()methode 
AS3 function removeAt(index:int):T

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 19, AIR 19

Verwijder een enkel element uit de Vector. Bij deze methode wordt de Vector gewijzigd zonder dat een kopie wordt gemaakt.

Parameters

index:int — Een geheel getal dat de index van het element in de Vector aangeeft dat moet worden verwijderd. U kunt een negatief geheel getal gebruiken om een positie op te geven ten opzichte van het einde van de Vector (bijvoorbeeld -1 is het laatste element van de Vector).

Geretourneerde waarde
T — Het element dat uit de Vector is verwijderd.

Gegenereerde uitzondering
RangeError — Als het argument index een te verwijderen index opgeeft die buiten de begrenzingen van de Vector valt.
 
RangeError — Als deze methode wordt aangeroepen terwijl fixed true is.

reverse

()methode 
AS3 function reverse():Vector.<T>

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Keert de volgorde van de elementen in de Vector om. Deze methode verandert de Vector waarvoor deze wordt aangeroepen.

Geretourneerde waarde
Vector.<T> — De Vector met de elementen in omgekeerde volgorde.

shift

()methode 
AS3 function shift():T

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Hiermee wordt het eerste element uit de Vector verwijderd en wordt dit element geretourneerd. De resterende Vectorelementen worden van hun oorspronkelijke positie verplaatst, van i naar i - 1.

Geretourneerde waarde
T — Het eerste element in de Vector.

Gegenereerde uitzondering
RangeError — Als fixed true is.

Verwante API-elementen

slice

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Retourneert een nieuwe Vector die bestaat uit een reeks elementen van de oorspronkelijke Vector. De oorspronkelijke Vector wordt niet gewijzigd. De geretourneerde Vector bevat het element startIndex en alle elementen tot (niet tot en met) het element endIndex.

Wanneer u geen parameters doorgeeft, is de nieuwe Vector een duplicaat (oppervlakkige kloon) van de oorspronkelijke Vector. Als u voor beide parameters een waarde 0 doorgeeft, wordt er een lege vector gemaakt van hetzelfde type als de originele vector.

Parameters

startIndex:int (default = 0) — Een getal dat de index van het beginpunt voor het segment opgeeft. Als startIndex een negatief getal is, begint het beginpunt aan het einde van de Vector, waarbij -1 het laatste element is.
 
endIndex:int (default = 16777215) — Een getal dat de index van het eindpunt voor het segment opgeeft. Als u deze parameter weglaat, bevat het segment alle elementen van het beginpunt tot het einde van de Vector. Als endIndex een negatief getal is, wordt het eindpunt opgegeven vanaf het einde van de Vector, waarbij -1 het laatste element is.

Geretourneerde waarde
Vector.<T> — Een Vector die bestaat uit een reeks elementen van de oorspronkelijke Vector.

some

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Voert een testfunctie uit op elk item in de Vector totdat een item wordt bereikt dat true retourneert. Gebruik deze methode om vast te stellen of items in een Vector aan een criterium voldoen, zoals het hebben van een waarde onder een bepaald getal.

Voor deze methode moet de tweede parameter, thisObject, gelijk aan null zijn wanneer de eerste parameter, callback, de methode afsluit. Dat is de meest gebruikelijke toepassing van deze methode.

Stel echter dat u een functie maakt op een frame in de hoofdtijdlijn, maar deze wilt aanroepen in een andere this-context:

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

Vervolgens gebruikt u de methode some() voor een Vector met de naam myVector:

     myVector.some(myFunction, someObject);
     

Omdat myFunction lid is van de hoofdklasse van het SWF-bestand, kan deze niet worden uitgevoerd in een andere this-context. Wanneer deze code wordt uitgevoerd, treedt een uitzonderingsfout op in Flash-runtimes. U kunt deze fout bij uitvoering voorkomen door de functie als volgt toe te wijzen aan een variabele:

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

Parameters

callback:Function — De functie die op elk item in de Vector moet worden uitgevoerd. Deze functie wordt met drie argumenten aangeroepen: het huidige item uit de Vector, de index van het item en het Vector-object:
function callback(item:T, index:int, vector:Vector.<T>):Boolean

De callback-functie moet een Booleaanse waarde retourneren.

 
thisObject:Object (default = null) — Het object waarnaar de identificatie this in de functie callback verwijst wanneer de functie wordt aangeroepen.

Geretourneerde waarde
Boolean — Een booleaanse waarde true als een of meer items in de Vector true retourneren voor de opgegeven functie; anders false.

Verwante API-elementen

sort

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Sorteert de elementen in het Vector-object en retourneert ook een gesorteerd Vector-object. Met deze methode worden de elementen gesorteerd aan de hand van de parameter sortBehavior. Dit is een functie waarmee twee waarden of een reeks sorteeropties worden vergeleken.

De methode maakt gebruik van één parameter. Het is een van de volgende parameters:

  • een functie die twee argumenten gebruikt van het basistype (T) van de vector en een nummer retourneert:
    function compare(x:T, y:T):Number {}

    De logica van de functie is dat op basis van twee elementen x en y de functie een van de volgende drie waarden retourneert:

    • een negatief getal, als x vóór y komt in de gesorteerde reeks
    • 0, als x gelijk is aan y
    • een positief getal, als x achter y komt in de gesorteerde reeks

  • een nummer dat een bitsgewijze OR van de volgende waarden is:
    • 1 of Array.CASEINSENSITIVE
    • 2 of Array.DESCENDING
    • 4 of Array.UNIQUESORT
    • 8 of Array.RETURNINDEXEDARRAY
    • 16 of Array.NUMERIC

    Als de waarde 0 is, werkt de sortering op de volgende manier:

    • Sorteren is hoofdlettergevoelig (Z komt eerder dan a).
    • Sorteren verloopt oplopend (a komt eerder dan b).
    • De array wordt gewijzigd op basis van de sorteervolgorde; meerdere elementen met identieke sorteervelden worden in willekeurige volgorde achter elkaar in de gesorteerde array geplaatst.
    • Alle elementen, ongeacht het gegevenstype, worden als tekenreeksen gesorteerd, 100 komt bijvoorbeeld eerder dan 99, omdat '1' een lagere tekenreekswaarde is dan '9'.

Parameters

sortBehavior:* — Een Function- of Number-waarde die het gedrag van de sortering bepaalt. Een Function-parameter geeft een vergelijkingsmethode aan. Een Number-waarde geeft de sorteeropties aan.

Geretourneerde waarde
Vector.<T> — Een Vector-object met elementen in de nieuwe volgorde.

Verwante API-elementen

splice

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Hiermee worden elementen aan de Vector toegevoegd en worden elementen uit de Vector verwijderd. Bij deze methode wordt de Vector gewijzigd zonder dat een kopie wordt gemaakt.

Opmerking: Als u deze methode in een subklasse van Vector wilt negeren, gebruikt u ...args voor de parameters, zoals getoond in dit voorbeeld:

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

Parameters

startIndex:int — Een geheel getal dat de index van het element in de Vector opgeeft waar het invoegen of verwijderen begint. U kunt een negatief geheel getal gebruiken om een positie op te geven ten opzichte van het einde van de Vector (bijvoorbeeld -1 is het laatste element van de Vector).
 
deleteCount:uint (default = 4294967295) — Een geheel getal dat het aantal elementen opgeeft dat moet worden verwijderd. Dit getal bevat het element dat in de parameter startIndex wordt opgegeven. Wanneer de waarde 0 is, worden geen elementen verwijderd.
 
... items — Een optionele lijst met een of meer door komma's gescheiden waarden die in de vector moet worden ingevoegd op het punt dat is opgegeven in de parameter beginIndex.

Geretourneerde waarde
Vector.<T> — Een Vector met de elementen die uit de oorspronkelijke Vector zijn verwijderd.

Gegenereerde uitzondering
RangeError — Als de argumenten startIndex en deleteCount een te verwijderen index opgeven die buiten de begrenzingen van de Vector vallen.
 
RangeError — Als deze methode wordt aangeroepen terwijl fixed true is en de splice()-bewerking de lengte van de Vector verandert.

toLocaleString

()methode 
public function toLocaleString():String

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Retourneert een tekenreeks die de elementen in de opgegeven Vector vertegenwoordigt. Elk element in de Vector, beginnend met index 0 en eindigend met de hoogste index, wordt omgezet in een samengevoegde tekenreeks en wordt gescheiden door komma's. In de ActionScript 3.0-implementatie retourneert deze methode dezelfde waarde als de methode Vector.toString().

Geretourneerde waarde
String — Een tekenreeks met Vectorelementen.

Verwante API-elementen

toString

()methode 
public function toString():String

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Retourneert een tekenreeks die de elementen in de Vector vertegenwoordigt. Elk element in de Vector, beginnend met index 0 en eindigend met de hoogste index, wordt omgezet in een samengevoegde tekenreeks en wordt gescheiden door komma's. Gebruik de methode Vector.join() om een aangepast scheidingsteken op te geven.

Geretourneerde waarde
String — Een tekenreeks met Vectorelementen.

Verwante API-elementen

unshift

()methode 
AS3 function unshift(... args):uint

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Hiermee worden een of meer elementen aan het begin van de Vector toegevoegd en wordt de nieuwe lengte van de Vector geretourneerd. De overige elementen in de Vector worden van hun oorspronkelijke positie verplaatst, van i naar i + het aantal nieuwe elementen.

Omdat deze functie meerdere argumenten kan bevatten, wordt het gegevenstype van de argumenten zelfs in strikte modus niet gecontroleerd bij de compilatie. Als een argument echter wordt goedgekeurd dat geen instantie is van het basistype, treedt tijdens runtime een uitzonderingsfout op.

Parameters

... args — Een of meer instanties van het basistype van de Vector die aan het begin van de Vector moeten worden ingevoegd.

Geretourneerde waarde
uint — Een geheel getal dat voor de nieuwe lengte van de Vector staat.

Gegenereerde uitzondering
TypeError — Als een argument geen instantie is van het basistype T van de Vector.
 
RangeError — Als deze methode wordt aangeroepen terwijl fixed true is.

Verwante API-elementen





[ X ]Waarom in het Engels?
Sommige inhoud van de Naslaggids voor ActionScript 3.0 staat in het Engels

Niet alle onderdelen van de Naslaggids voor ActionScript 3.0 zijn in alle talen vertaald. Wanneer een taalelement niet is vertaald, wordt het in het Engels weergegeven. Zo is de klasse ga.controls.HelpBox niet in elke taal vertaald. In de Nederlandse versie van de naslaggids wordt de klasse ga.controls.HelpBox bijvoorbeeld in het Engels weergegeven.