Pakket | Hoofdniveau |
Klasse | public dynamic class Vector |
Overerving | Vector Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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()
ofunshift()
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
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
constructor : 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 |
Methode | Gedefinieerd door | ||
---|---|---|---|
Maakt een vector met het opgegeven basistype. | Vector | ||
Hiermee worden de vectoren die in de parameterlijsten zijn opgegeven, samengevoegd met de elementen in deze vector en wordt een nieuwe vector gemaakt. | Vector | ||
Hiermee wordt een testfunctie uitgevoerd op elk item in de Vector totdat een item wordt bereikt dat voor de opgegeven functie onwaar retourneert. | Vector | ||
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 | ||
Hiermee wordt een functie uitgevoerd op elk item in de Vector. | Vector | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Zoekt een item in de Vector en retourneert de indexpositie van het item. | Vector | ||
Voeg een enkel element in de Vector in. | Vector | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
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 | ||
Zoekt een item in de Vector, achterwaarts vanaf de opgegeven indexpositie, en retourneert de indexpositie van het gevonden item. | Vector | ||
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 | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Hiermee worden een of meer elementen aan het einde van de Vector toegevoegd en wordt de nieuwe lengte van de Vector geretourneerd. | Vector | ||
Verwijder een enkel element uit de Vector. | Vector | ||
Keert de volgorde van de elementen in de Vector om. | Vector | ||
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 | ||
Retourneert een nieuwe Vector die bestaat uit een reeks elementen van de oorspronkelijke Vector. De oorspronkelijke Vector wordt niet gewijzigd. | Vector | ||
Voert een testfunctie uit op elk item in de Vector totdat een item wordt bereikt dat true retourneert. | Vector | ||
Sorteert de elementen in het Vector-object en retourneert ook een gesorteerd Vector-object. | Vector | ||
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 | ||
Retourneert de primitieve waarde van het opgegeven object. | Object |
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 desplice()
-aanroep delengte
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).
|
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
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
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.
|
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.
|
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.
|
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.
|
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.
|
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 |
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.
|
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.
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.
|
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).
|
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 waardeVector.<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 waardeT — 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.
|
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.
|
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
eny
de functie een van de volgende drie waarden retourneert:- een negatief getal, als
x
vóóry
komt in de gesorteerde reeks - 0, als
x
gelijk is aany
- een positief getal, als
x
achtery
komt in de gesorteerde reeks
- een negatief getal, als
- 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'.
- 1 of
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.
|
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 .
|
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()
.
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.
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.
|
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
Wed Jun 13 2018, 11:42 AM Z