Översta nivån 

Ett specialvärde som representerar negativ Infinity. Värdet för den här konstanten är samma som Number.NEGATIVE_INFINITY.

Relaterade API-element

trace(0 / 0);  // NaN
trace(7 / 0);  // Infinity
trace(-7 / 0); // -Infinity

Ett specialvärde som representerar positiv Infinity. Värdet för den här konstanten är samma som Number.POSITIVE_INFINITY.

Relaterade API-element

trace(0 / 0);  // NaN
trace(7 / 0);  // Infinity
trace(-7 / 0); // -Infinity

En specialmedlem i datatypen Number som representerar ett värde som inte är ett tal (NaN, Not a Number). När ett matematiskt uttryck resulterar i ett värde som inte kan uttryckas som ett tal, är resultatet NaN. I följande lista beskrivs de vanligaste uttrycken som resulterar i NaN.

• Division med 0 resulterar endast i NaN om divisorn också är 0. Om divisorn är större än 0, resulterar division med 0 i Infinity. Om divisorn är mindre än 0, resulterar division med 0 i -Infinity;
• Kvadratroten ur ett negativt tal.
• Arcussinus av ett tal utanför giltigt intervall, 0 till 1.
• Infinity subtraherat från Infinity.
• Infinity eller -Infinity dividerat med Infinity eller -Infinity.
• Infinity eller -Infinity multiplicerat med 0.

Värdet NaN är inte medlem av datatypen int eller uint.

Värdet NaN anses inte vara lika med något annat värde, inklusive NaN. Det är därför omöjligt att använda likhetsoperatorn om du vill testa om ett uttryck ärNaN. Om du vill avgöra om ett tal är NaN använder du funktionen isNaN().

Relaterade API-element

Ett specialvärde som används för typlösa variabler som inte har initierats eller dynamiska objektegenskaper som inte har initierats. I ActionScript 3.0 kan endast variabler som inte är typbestämda ha värdet undefined, vilket inte gäller i ActionScript 1.0 eller ActionScript 2.0. Följande två variabler är till exempel undefined eftersom de är typlösa och oinitierade:

• var foo;
• var bar:*;

Värdet undefined gäller även för oinitierade egenskaper för dynamiska objekt. Om ett objekt till exempel är en instans av Object-klassen är värdet på en dynamiskt tillagd egenskap undefined tills ett värde tilldelas den egenskapen.

Resultaten varierar när undefined används med olika funktioner:

• Värdet som returneras av String(undefined) är "undefined" (undefined konverteras till en sträng).
• Värdet som returneras av Number(undefined) är NaN.
• Värdet som returneras av int(undefined) och uint(undefined) är 0.
• Värdet som returneras av Object(undefined) är en ny Object-instans.
• När värdet undefined tilldelas till en variabel med en angiven datatyp konverteras värdet till standardvärdet för den datatypen.

Blanda inte ihop undefined och null. När null och undefined jämförs med likhetsoperatorn (==) betraktas de som lika. När null och undefined jämförs med operatorn strikt likhet (===) betraktas de som olika.

Relaterade API-element

// trace value of untyped and uninitialized variable
var myVar;
trace(myVar); // undefined

dynamic class A {}
var obj:A = new A()

// trace undefined property of obj
trace(obj.propName); // undefined

Skapar en ny array. Arrayen kan ha längden noll eller mer eller vara en array med ett enda angivet objekt.

• Om du anropar Array() utan argument returneras en tom array.
• Om du anropar Array() med ett argument som är ett heltal returneras en array av angiven längd, men vars element har odefinierade värden.
• Om du anropar Array() med ett angivet objekt returneras en array med ett element av det angivna objektet.

Obs! Om du försöker använda funktionen Array() för att skapa en ny array, och skickar flera värden som parametrar för att fylla arrayen, genereras ett kompileringsfel. Du kan bara använda en parameter med funktionen Array(). Använd i stället Array-klasskonstruktorn för att skapa och fylla en array med flera värden.

Funktionen Array() inkluderar inte typen för ett objekt i en array. Använd operatorn as för explicit typkonvertering eller datatypsbyte, när argumentet inte är ett primitivt värde. Mer information finns under Exempel. Om du skickar ett objekt som en parameter till funktionen Array() skapas en ny array med det objektet som ett element.

Parametrar

Relaterade API-element

var obj:Object = [ "a", "b", "c" ];
      
var newArray:Array = Array( obj );

trace(newArray == obj);    // false
trace(newArray[0] == obj); // true
trace(newArray[0][0])      // a
trace(newArray[0][1])      // b
trace(newArray[0][2])      // c

var obj:Object = [ "a", "b", "c" ];
      
var newArray:Array = obj as Array;

trace(newArray == obj); // true
trace(newArray[0]);     // a
trace(newArray[1]);     // b
trace(newArray[2]);     // c

Konverterar parametern expression till ett Boolean-värde och returnerar värdet.

Vilket värde som returneras beror på datatypen och värdet på argumentet, enligt följande tabell:

Till skillnad från tidigare versioner av ActionScript returnerar funktionen Boolean() samma resultat som klasskonstruktorn Boolean.

Parametrar

Avkodar en kodad URI till en sträng. Returnerar en sträng där alla tecken som tidigare kodades av funktionen encodeURI återställs till sin okodade representation.

I följande tabell visas uppsättningen escape-sekvenser som inte avkodas till tecken av funktionen decodeURI. Använd decodeURIComponent() om du vill avkoda escape-sekvenserna i den här tabellen.

Parametrar

Relaterade API-element

package {
    import flash.display.Sprite;

    public class DecodeURIExample extends Sprite {
        public function DecodeURIExample() {
            var uri:String = "http://www.example.com/application.jsp?user=<user name='some user'></user>";
            var encoded:String = encodeURI(uri);
            var decoded:String = decodeURI(encoded);
            trace(uri);        // http://www.example.com/application.jsp?user=<user name='some user'></user>
            trace(encoded);    // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E
            trace(decoded);    // http://www.example.com/application.jsp?user=<user name='some user'></user>
        }
    }
}

Avkodar en kodad URI-komponent till en sträng. Returnerar en sträng där alla tecken som tidigare escape-konverterades av funktionen encodeURIComponent återställs till sin okodade representation.

Den här funktionen skiljer sig från funktionen decodeURI() eftersom den är avsedd att användas med endast en del av en URI-sträng, som kallas för URI-komponent. En URI-komponent är text som befinner sig mellan specialtecken som kallas för komponentavgränsare (: / ; och ? ). Vanliga exempel på en URI-komponent är "http" och "www.adobe.com".

En annan viktig skillnad mellan den här funktionen och decodeURI() är att eftersom funktionen antar att den hanterar en URI-komponent så behandlas de escape-sekvenser som representerar speciella avgränsningstecken (; / ? : @ & = + $ , #) som vanlig text som ska avkodas.

Parametrar

Relaterade API-element

Kodar en sträng till en giltig URI (Uniform Resource Identifier). Konverterar en komplett URI till en sträng där alla tecken kodas som escape-sekvenser enligt UTF-8, om inte ett tecken tillhör en liten grupp grundläggande tecken.

I följande tabell visas hela uppsättningen av grundläggande tecken som inte konverteras till escape-sekvenser enligt UTF-8 av funktionen encodeURI.

Parametrar

Relaterade API-element

package {
    import flash.display.Sprite;

    public class EncodeURIExample extends Sprite {
        public function EncodeURIExample() {
            var uri:String = "http://www.example.com/application.jsp?user=<user name='some user'></user>";
            var encoded:String = encodeURI(uri);
            var decoded:String = decodeURI(encoded);
            trace(uri);        // http://www.example.com/application.jsp?user=<user name='some user'></user>
            trace(encoded);    // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E
            trace(decoded);    // http://www.example.com/application.jsp?user=<user name='some user'></user>
        }
    }
}

Kodar en sträng till en giltig URI-komponent. Konverterar en delsträng av en URI till en sträng där alla tecken kodas som escape-sekvenser enligt UTF-8, om inte ett tecken tillhör en väldigt liten grupp av grundläggande tecken.

Funktionen encodeURIComponent() skiljer sig från funktionen encodeURI() eftersom den är avsedd att användas med endast en del av en URI-sträng, en så kallad URI-komponent. En URI-komponent är text som befinner sig mellan specialtecken som kallas för komponentavgränsare (: / ; och ? ). Vanliga exempel på en URI-komponent är "http" och "www.adobe.com".

En annan viktig skillnad mellan den här funktionen och encodeURI() är att eftersom funktionen antar att den hanterar en URI-komponent så behandlas de speciella avgränsningstecknen (; / ? : @ & = + $ , #) som vanlig text som ska kodas.

I följande tabell visas alla tecken som inte konverteras till escape-sekvenser enligt UTF-8 av funktionen encodeURIComponent.

Parametrar

Relaterade API-element

Konverterar parametern till en sträng och kodar den till ett URL-kodat format, där de flesta tecken som inte är alfanumeriska ersätts med % hexadecimala sekvenser. När procentsymbolen (%) används i en URL-kodad sträng introducerar den undantagstecken och är inte ekvivalent med operatorn modulo (%).

I följande tabell visas alla tecken som inte konverteras till escape-sekvenser av funktionen escape().

Obs! Använd funktionen encodeURIComponent(), i stället för funktionen escape(), om du vill att avgränsningstecken (som @ + /) ska behandlas som vanlig text som ska kodas.

Parametrar

Relaterade API-element

Konverterar ett givet numeriskt värde till ett heltalsvärde. Decimaltal trunkeras vid decimalkommat.

Parametrar

Relaterade API-element

Returnerar true om värdet är ett finit tal. Om värdet är Infinity eller -Infinity returneras false. Infinity eller -Infinity påvisar ett matematiskt feltillstånd, till exempel division med 0.

Parametrar

Returnerar true om värdet är NaN (Not a Number, inte ett tal). Funktionen isNaN() kontrollerar om ett matematiskt uttryck utvärderas till ett tal på rätt sätt. isNaN() används mest för att kontrollera det värde som returneras från funktionerna parseInt() och parseFloat(). Värdet NaN är en specialmedlem av datatypen Number, som representerar ett värde som inte är ett tal (Not a Number).

Obs: Värdet NaN är inte medlem av datatypen int eller uint.

I följande tabell beskrivs returvärdet av isNaN() för olika indatatyper och värden. (Om du har kompileringsvarningar inställda på strikt läge kommer några av följande åtgärder att generera kompileringsvarningar.)

Parametrar

Avgör om den angivna strängen är ett giltigt namn för ett XML-element eller -attribut.

Parametrar

Konverterar ett givet värde till ett Number-värde. I följande tabell visas resultatet av olika indatatyper:

Parametrar

Alla värden i ActionScript 3.0 är objekt, vilket innebär att anrop till Object() för ett värde returnerar värdet.

Parametrar

Konverterar en sträng till ett flyttalsnummer. Funktionen läser, eller tolkar, och returnerar talen i en sträng tills den når ett tecken som inte är del av det första talet. Om strängen inte börjar med ett tal som kan tolkas returnerar parseFloat() NaN. Mellanrum före giltiga heltal ignoreras, liksom efterföljande icke-numeriska tecken.

Parametrar

Konverterar en sträng till ett heltal. Om den angivna strängen i parametrarna inte kan konverteras till ett tal returnerar funktionen NaN. Strängar som börjar med 0x tolkas som hexadecimala tal. Till skillnad från tidigare versioner av ActionScript tolkas inte heltal som börjar med 0 som oktala tal. Du måste ange talbasen 8 för oktala tal. Mellanrum och nollor före giltiga heltal ignoreras, liksom efterföljande icke-numeriska tecken.

Parametrar

Returnerar en strängbeteckning för den angivna parametern.

I följande tabell visas resultatet av olika indatatyper:

Parametrar

Visar uttryck eller skriver i loggfiler under felsökning. En trace-programsats kan ta flera argument. Om ett argument i en trace-programsats innefattar en annan datatyp än String, anropar funktionen trace den associerade toString()-metoden för den datatypen. Om argumentet till exempel är ett booleskt värde anropar trace-funktionen Boolean.toString() och visar returvärdet.

Parametrar

package {
    import flash.display.Sprite;

    public class TraceExample extends Sprite {

        public function TraceExample() {
            trace("Hello World");
        }
    }
}

Konverterar ett givet numeriskt värde till ett heltalsvärde utan tecken. Decimaltal trunkeras vid decimalkommat.

I följande tabell beskrivs returvärdet av uint() för olika indatatyper och värden.

Parametrar

Relaterade API-element

Utvärderar parametern str som sträng, avkodar strängen från URL-kodat format (konverterar alla hexadecimala sekvenser till ASCII-tecken) och returnerar strängen.

Parametrar

Skapar en ny Vector-instans vars element är instanser av den angivna datatypen. När du anropar den här funktionen anger du datatypen för elementen hos resultat-Vector (bastyp hos Vector) med en typparameter. Denna funktion använder samma syntax som används när en Vector-instans deklareras eller vid anrop av new Vector.<T>()-konstruktorn:

var v:Vector.<String> = Vector.<String>(["Hello", "World"]);

Resultat-Vector fylls med värdena i elementen i sourceArray-argumentet. Om sourceArray-argumentet redan är en Vector.<T>-instans där T är bastypen, returnerar funktionen den Vector. I annat fall fylls resultat-Vector med elementen i sourceArray-Arrayen eller -Vector.

Datatypen för alla element i sourceArray-argumentet måste alltid överensstämma med bastypen T som har angivits i funktionsanropet.

Om sourceArray-argumentet har length-värdet 0, returnerar funktionen en tom Vector.

Om en Vector skickas som sourceArray-argument och dess bastyp inte är T, eller om en Array skickas och alla dess element inte är instanser av datatypen T, görs ett försök att konvertera värdena till bastypen. Om värdena kan konverteras automatiskt innehåller resultat-Vector de konverterade värdena. Om konvertering inte kan genomföras inträffar ett fel.

Om ett element i sourceArray-argumentet är en instans av en underklass till bastypen T, lyckas anropet och elementet läggs till i resultat-Vector. Detta fungerar även om sourceArray-argumentet är en Vector vars bastyp är en underklass till T. Detta är i själva verket det enda sättet att konvertera en Vector med bastypen T till en Vector med en bastyp som är en superklass till T.

Följande kod resulterar till exempel i ett kompileringsfel i strikt läge, eller ett TypeError-fel vid körning, eftersom det försöker tilldela en Vector.<Sprite> till en Vector.<DisplayObject>-variabel (Sprite är en underklass till DisplayObject):

     var v1:Vector.<Sprite> = new Vector.<Sprite>();
     v1[0] = new Sprite();
     var v2:Vector.<DisplayObject> = v1;
     

Med följande alternativa kodversion lyckas kopieringen av elementen i en Vector.<Sprite>-instans till en Vector.<DisplayObject>-instans:

     var v1:Vector.<Sprite> = new Vector.<Sprite>();
     v1[0] = new Sprite();
     var v2:Vector.<DisplayObject> = Vector.<DisplayObject>(v1);
     

Parametrar

Relaterade API-element

Konverterar ett objekt till ett XML-objekt.

I följande tabell beskrivs returvärdena för olika indatatyper.

Parametrar

Relaterade API-element

Konverterar ett objekt till ett XMLList-objekt.

I följande tabell beskrivs returvärdena för olika indatatyper.

Parametrar

Relaterade API-element