Najwyższy poziom 

Wartość specjalna reprezentująca ujemną wartość Infinity. Wartość tej stałej jest taka sama, jak wartość Number.NEGATIVE_INFINITY.

Powiązane elementy interfejsu API

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

Wartość specjalna reprezentująca dodatnią wartość Infinity. Wartość tej stałej jest taka sama, jak wartość Number.POSITIVE_INFINITY.

Powiązane elementy interfejsu API

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

Specjalny element typu danych Number, który reprezentuje wartość nieliczbową (NaN). Jeśli wynikiem wyrażenia matematycznego jest wartość, której nie można wyrazić liczbą, wynik ten ma wartość NaN. Poniżej znajduje się lista zawierająca najczęściej występujące wyrażenia, których wynikiem jest wartość NaN.

• Wynikiem dzielenia przez 0 jest wartość NaN tylko w przypadku, gdy dzielnik jest również liczbą 0. Jeśli dzielnik jest liczbą większą od 0, wynikiem dzielenia przez 0 jest wartość Infinity. Jeśli dzielnik jest liczbą mniejszą od 0, wynikiem dzielenia przez 0 jest wartość -Infinity;
• Pierwiastek kwadratowy z liczby ujemnej;
• Arcus sinus liczby spoza poprawnego zakresu od 0 do 1;
• Wartość Infinity odjęta od wartości Infinity;
• Wartość Infinity lub wartość -Infinity dzielona przez wartość Infinity lub wartość -Infinity;
• Wartość Infinity lub wartość -Infinity mnożona przez 0;

Wartość NaN nie należy do typów danych int ani uint.

Wartość NaN nie jest równa żadnej innej wartości, w tym wartości typu NaN, co wyklucza użycie operatora równości w celu sprawdzenia, czy wartość wyrażenia to NaN. Aby określić, czy liczba jest funkcją NaN, należy użyć funkcji isNaN().

Powiązane elementy interfejsu API

Wartość specjalna, która jest stosowana do niezainicjowanych zmiennych bez typu lub niezainicjowanych właściwości obiektów dynamicznych. W narzędziu ActionScript 3.0 tylko zmienne bez typu mogą przyjmować wartość undefined, co nie sprawdza się w przypadku wersji ActionScript 1.0 i ActionScript 2.0. Na przykład obydwie poniższe zmienne mają wartość undefined ponieważ nie posiadają typu i nie zostały zainicjowane:

• var foo;
• var bar:*;

Wartość undefined ma zastosowanie również do właściwości bez typu lub niezainicjowanych, a należących do obiektów dynamicznych. Przykład: Jeśli obiekt stanowi instancję klasy Object, każda dynamicznie dodana właściwość będzie miała wartość undefined, chyba że właściwości zostanie przypisana wartość.

Rezultaty użycia wartości undefined z różnymi funkcjami są różne:

• Wartość zwrócona przez funkcję String(undefined) to "undefined" (wartość undefined jest konwertowana na ciąg znaków).
• Wartość zwrócona przez funkcję Number(undefined) to NaN.
• Wartość zwrócona przez funkcję int(undefined) i uint(undefined) to 0.
• Wartość zwrócona przez funkcję Object(undefined) to nowa instancja Object.
• Jeśli wartość to undefined, zostanie przypisana do zmiennej o określonym typie, jest konwertowana na wartość domyślną dla tego typu danych.

Nie należy mylić wartości undefined z wartością null. Porównanie wartości null i undefined z pomocą operatora równości (==) wykaże ich równoważność. Porównanie wartości null i undefined za pomocą operatora ścisłej równości (===) wykaże jednak, że te wartości nie są równoważne.

Powiązane elementy interfejsu API

// 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

Tworzy nową tablicę. Tablica może mieć długość zerową lub większą. Można w niej również umieścić jeden (podany) obiekt.

• Wywołanie funkcji Array() bez argumentów spowoduje zwrot pustej tablicy.
• Wywołanie funkcji Array() z pojedynczym argumentem liczby całkowitej spowoduje, że zwrócona tablica będzie miała określoną długość, a jej elementy będą posiadały wartość undefined.
• Wywołanie funkcji Array() dla określonego obiektu zwraca tablicę z jednym elementem — tym obiektem.

Uwaga: Próba utworzenia nowej tablicy i przekazania do niej wielu wartości jako parametrów funkcji Array() w celu wypełnienia tej tabeli wywoła błąd kompilatora. Funkcja Array() pozwala użyć tylko jednego parametru. W celu utworzenia tablicy i wypełnienia jej wieloma wartościami należy użyć konstruktora klasy Array.

Funkcja Array() nie rzutuje typu obiektu na tablicę. Operatora as można używać do jawnej konwersji typu lub do rzutowania typu, jeśli argument nie jest wartością pierwotną. Więcej informacji można znaleźć z sekcji Przykłady dla tego elementu języka. W przypadku przekazania obiektu jako parametru do funkcji Array() zostanie utworzona nowa tablica zawierająca ten obiekt jako element.

Parametry

Powiązane elementy interfejsu API

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

Konwertuje parametr expression na wartość typu Boolean i zwraca ją.

Zwrócona wartość zależy od typu danych i wartości argumentu, jak opisano w poniższej tabeli:

W przeciwieństwie do starszych wersji narzędzia ActionScript, funkcja Boolean() zwraca te same wyniki co konstruktor klasy Boolean.

Parametry

Przekształca zakodowany identyfikator URI w ciąg znaków. Zwraca ciąg znaków, w którym wszystkie wcześniej zakodowane za pomocą funkcji encodeURI znaki zostały przywrócone do swojej reprezentacji sprzed kodowania.

Poniższy przykład przedstawia zbiór sekwencji zmiany znaczenia, które nie są dekodowane przez funkcję decodeURI. Do zdekodowania sekwencji zmiany znaczenia z tej tabeli należy używać metody decodeURIComponent().

Parametry

Powiązane elementy interfejsu API

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>
        }
    }
}

Przekształca zakodowany składnik URI w ciąg znaków. Zwraca ciąg znaków, w którym wszystkie wcześniej zakodowane za pomocą funkcji encodeURIComponent znaki zostały przywrócone do swojej reprezentacji sprzed kodowania.

Ta funkcja różni się od funkcji decodeURI(), gdyż można jej używać tylko z fragmentem ciągu URI określanym jako składnik URI. Składnik URI to dowolny tekst pojawiający się między znakami specjalnymi nazywanymi separatorami składników (: / ; oraz ? ). Typowymi przykładami składników URI są „http” i „www.adobe.com”.

Ponadto, w odróżnieniu od funkcji decodeURI(), ta funkcja zakłada, iż przetwarza składnik identyfikatora URI i z tego względu traktuje wszystkie znaki zmiany znaczenia reprezentujące separatory (; / ? : @ & = + $ , #) jak regularny tekst, który należy zdekodować.

Parametry

Powiązane elementy interfejsu API

Przekształca ciąg znaków w poprawny identyfikator URI (Uniform Resource Identifier). Konwertuje cały identyfikator URI na ciąg, w którym wszystkie znaki — oprócz znaków należących do bardzo małej grupy znaków podstawowych— są zakodowane jako sekwencje zmiany znaczenia UTF-8.

Poniższy przykład ilustruje cały zbiór znaków podstawowych, które nie są konwertowane na sekwencje zmiany znaczenia UTF-8 przez funkcję encodeURI.

Parametry

Powiązane elementy interfejsu API

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>
        }
    }
}

Przekształca ciąg znaków w poprawny składnik URI. Konwertuje fragment ciągu identyfikatora URI na ciąg, w którym wszystkie znaki — oprócz znaków należących do bardzo małej grupy znaków podstawowych— są zakodowane jako sekwencje zmiany znaczenia UTF-8.

Funkcja encodeURIComponent() różni się od funkcji encodeURI(), gdyż można jej używać tylko z fragmentem ciągu stanowiącym identyfikator URI określanym jako składnik URI. Składnik URI to dowolny tekst pojawiający się między znakami specjalnymi nazywanymi separatorami składników (: / ; oraz ? ). Typowymi przykładami składników URI są „http” i „www.adobe.com”.

Ponadto, w odróżnieniu od funkcji encodeURI(), ta funkcja zakłada, iż przetwarza składnik identyfikatora URI i z tego względu traktuje wszystkie znaki specjalne separatorów (; / ? : @ & = + $ , #) jako regularny tekst, który należy zakodować.

Poniższa tabela zawiera wszystkie znaki, które nie są konwertowane na sekwencje zmiany znaczenia UTF-8 przez funkcję encodeURIComponent.

Parametry

Powiązane elementy interfejsu API

Konwertuje parametr na ciąg znaków i koduje go w formacie adresu URL, gdzie większość znaków niebędących znakami alfanumerycznymi zastępowana jest szesnastkowymi sekwencjami symbolu %. W przypadku ciągu znaków w formacie adresu URL w celu wprowadzenia znaków zmiany znaczenia używany jest symbol procentu (%), który nie jest równoważny z operatorem modulo (%).

Poniższa tabela zawiera wszystkie znaki, które nie są konwertowane na sekwencje zmiany znaczenia za pomocą funkcji escape().

Uwaga: W przypadku użycia funkcji encodeURIComponent() zamiast escape() znaki specjalne separatora (@ + /) są traktowane jako zwykły tekst do zakodowania.

Parametry

Powiązane elementy interfejsu API

Konwertuje daną wartość liczbową na wartość liczby całkowitej. Wartości dziesiętne są odcinane w miejscu kropki dziesiętnej.

Parametry

Powiązane elementy interfejsu API

W przypadku liczby skończonej zwraca wartość true. W przypadku wartości Infinity lub -Infinity zwraca wartość false. Wartość Infinity lub -Infinity wskazuje na wystąpienie błędu matematycznego, jak np. dzielenie przez 0.

Parametry

Zwraca wartość true dla wartości NaN (nie liczba). Za pomocą funkcji isNaN() można sprawdzić, czy analizowane wyrażenie matematyczne jest liczbą. Najczęstsze zastosowanie isNaN() to sprawdzenie wartości zwracanej przez funkcje parseInt() i parseFloat(). Wartość NaN to specjalny element typu danych Number, który reprezentuje wartość nieliczbową.

Uwaga: Wartość NaN nie należy do typów danych int ani uint.

Poniższa tabela opisuje wartości zwracane przez funkcję isNaN() dla różnych wejściowych typów danych i wartości. (Jeśli ostrzeżenia kompilatora są wysyłane w trybie dokładnym, niektóre z poniższych operacji będą generowały ostrzeżenia kompilatora).

Parametry

Określa, czy podany ciąg jest poprawną nazwą elementu lub atrybutu XML.

Parametry

Konwertuje daną wartość liczbową na wartość typu Number. Poniższa tabela przedstawia rezultaty dla różnych typów danych wejściowych:

Parametry

W narzędziu ActionScript 3.0 każda wartość jest obiektem, z zatem w wyniku wywołania funkcji Object() dla wartości otrzymuje się zawsze wartość.

Parametry

Konwertuje ciąg znaków na liczbę zmiennoprzecinkową. Funkcja odczytuje lub analizuje składniowo i zwraca liczby w ciągu znaków do momentu wystąpienia znaku, który nie będzie częścią początkowej liczby. Jeśli ciąg znaków nie rozpoczyna się liczbą, którą można analizować składniowo, funkcja parseFloat() zwraca wartość NaN. Białe znaki poprzedzające poprawne liczby całkowite, jak i wprowadzające znaki nienumeryczne są pomijane.

Parametry

Konwertuje ciąg znaków na liczbę całkowitą. Jeśli określonego w parametrach ciągu znaków nie można konwertować na liczbę, funkcja zwraca wartość NaN. Ciągi znaków rozpoczynające się znakami 0x są interpretowane jako liczby szesnastkowe. W przeciwieństwie do wcześniejszych wersji, w tej wersji narzędzia ActionScript liczby całkowite rozpoczynające się cyfrą 0 nie są interpretowane jako liczby ósemkowe. Dla liczb ósemkowych należy określić podstawę 8. Białe znaki i zera poprzedzające poprawne liczby całkowite, jak również nienumeryczne znaki wprowadzające są pomijane.

Parametry

Zwraca ciąg reprezentujący określony parametr.

Poniższa tabela przedstawia rezultaty dla różnych typów danych wejściowych:

Parametry

W trakcie debugowania wyświetla wyrażenia lub zapisuje informacje w dzienniku. Pojedyncza instrukcja trace może obsługiwać wiele argumentów. Jeśli argument w instrukcji trace zawiera typ danych inny niż String, funkcja trace wywołuje skojarzoną metodę toString() dla tego typu danych. Jeśli na przykład argument stanowi wartość typu Boolean, funkcja trace wywołuje metodę Boolean.toString() i wyświetla zwróconą wartość.

Parametry

package {
    import flash.display.Sprite;

    public class TraceExample extends Sprite {

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

Konwertuje daną wartość liczbową na liczbę całkowitą bez znaku. Wartości dziesiętne są odcinane w miejscu kropki dziesiętnej.

Poniższy przykład ilustruje wartość zwróconą przez funkcję uint() dla różnych typów i wartości wejściowych.

Parametry

Powiązane elementy interfejsu API

Analizuje parametr str jako ciąg znaków, odtwarza reprezentację ciągu znaków sprzed kodowania formacie URL (poprzez konwersję wszystkich sekwencji szesnastkowych na znaki ASCII) i zwraca ciąg znaków.

Parametry

Tworzy nową instancję Vector, której elementy są instancjami określonego typu danych. Wywołanie tej funkcji spowoduje określenie za pomocą parametru type typu danych elementów wynikowej instancji Vector (typ bazowy instancji Vector). Ta funkcja korzysta ze składni używanej do deklaracji instancji Vector lub wywoływania konstruktora new Vector.<T>():

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

Wynikowa instancja Vector zapełniania jest wartościami w postaci elementów argumentu sourceArray. Jeśli argument sourceArray stanowi już instancję Vector.<T>, gdzie T określa typ bazowy, funkcja zwraca te instancję Vector. W przeciwnym razie wynikowa instancja Vector jest zapełniana elementami argumentu Array sourceArray lub instancji Vector.

W obydwu przypadkach typ danych wszystkich elementów argumentu sourceArray musi być zgodny z typem bazowym T określonym dla wywołania funkcji.

Jeśli argument sourceArray posiada właściwość length o wartości 0, funkcja zwraca pustą instancję Vector.

Jeśli typ bazowy przekazanej jako argument sourceArray instancji Vector nie jest typem T lub jeśli nie wszystkie elementy przekazanego obiektu Array są instancjami należącymi do typu danych T, następuje próba konwertowania wartości na typ bazowy. W przypadku możliwości automatycznej konwersji wartości wynikowa instancja Vector zawierać będzie wartości po konwersji. W przypadku braku możliwości konwersji generowany jest błąd.

Podobnie dzieje się w przypadku, gdy element argumentu sourceArray jest instancją podklasy typu bazowego T. Wywołanie przebiega pomyślnie, a element jest dodawany do wynikowej instancji Vector. Sprawdza się to nawet w przypadku, gdy argument sourceArray jest instancją Vector, której typ bazowy stanowi podklasę typu T. W rzeczywistości jest to jedyny sposób na przeprowadzenie konwersji instancji Vector o typie bazowym T na instancję Vector, której typ bazowy jest nadklasą dla typu T.

Przykład: wynikiem wykonania poniższego kodu jest błąd kompilacji w trybie dokładnym lub błąd TypeError środowiska wykonawczego wywołany próbą przypisania instancji Vector.<Sprite> do instancji Vector.Zmienna <DisplayObject> (Sprite stanowi podklasę zmiennej DisplayObject):

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

Za pomocą poniższej, alternatywnej wersji kodu można pomyślnie przeprowadzić kopiowanie elementów instancji Vector.<Sprite> do instancji Vector.Instancja <DisplayObject>:

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

Parametry

Powiązane elementy interfejsu API

Konwertuje obiekt na obiekt XML.

Poniższa tabela przedstawia wartości zwracane dla różnych typów danych wejściowych.

Parametry

Powiązane elementy interfejsu API

Konwertuje obiekt na obiekt XMLList.

Poniższa tabela przedstawia wartości zwracane dla różnych typów danych wejściowych.

Parametry

Powiązane elementy interfejsu API