Stałe i funkcje najwyższego poziomu - Szczegóły Adobe ActionScript® 3 (AS3)

Funkcje najwyższego poziomu (globalne) są dostępne we wszystkich częściach pliku SWF, w których używany jest kod ActionScript, oraz we wszystkich klasach zdefiniowanych przez użytkownika. Większość funkcji globalnych języka ActionScript 2.0 została przeniesiona do klas.

Funkcje globalne

	Funkcja		Zdefiniowane przez
		Array(... args):Array Tworzy nową tablicę.	Najwyższy poziom
		Boolean(expression:Object):Boolean Konwertuje parametr expression na wartość Boolean i na wartość typu Boolean i zwraca ją.	Najwyższy poziom
		decodeURI(uri:String):String Przekształca zakodowany identyfikator URI w ciąg znaków.	Najwyższy poziom
		decodeURIComponent(uri:String):String Przekształca zakodowany składnik URI w ciąg znaków.	Najwyższy poziom
		encodeURI(uri:String):String Przekształca ciąg znaków w poprawny identyfikator URI (Uniform Resource Identifier).	Najwyższy poziom
		encodeURIComponent(uri:String):String Przekształca ciąg znaków w poprawny składnik URI.	Najwyższy poziom
		escape(str:String):String Konwertuje parametr na ciąg znaków i koduje go w formacie adresu URL (większość znaków alfanumerycznych jest zastępowana sekwencjami szesnastkowymi %).	Najwyższy poziom
		int(value:Number):int Konwertuje daną wartość liczbową na wartość liczby całkowitej.	Najwyższy poziom
		isFinite(num:Number):Boolean W przypadku liczby skończonej zwraca wartość true. W przypadku wartości Infinity lub -Infinity zwraca wartość false.	Najwyższy poziom
		isNaN(num:Number):Boolean Zwraca prawdę, jeśli wartość nie jest liczbą.	Najwyższy poziom
		isXMLName(str:String):Boolean Określa, czy podany ciąg znaków jest poprawną nazwą elementu lub atrybutu XML.	Najwyższy poziom
		Number(expression:Object):Number Konwertuje daną wartość liczbową na wartość typu Number.	Najwyższy poziom
		Object(value:Object):Object W programie ActionScript 3.0 każda wartość jest obiektem, a zatem w wyniku wywołania funkcji Object() dla wartości otrzymuje się zawsze wartość.	Najwyższy poziom
		parseFloat(str:String):Number Konwertuje ciąg znaków na liczbę zmiennoprzecinkową.	Najwyższy poziom
		parseInt(str:String, radix:uint = 0):Number Konwertuje ciąg znaków na liczbę całkowitą.	Najwyższy poziom
		String(expression:Object):String Zwraca ciąg znaków reprezentujący określony parametr.	Najwyższy poziom
		trace(... arguments):void W trakcie debugowania wyświetla wyrażenia lub zapisuje informacje w dzienniku.	Najwyższy poziom
		uint(value:Number):uint Konwertuje daną wartość liczbową na liczbę całkowitą bez znaku.	Najwyższy poziom
		unescape(str:String):String 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.	Najwyższy poziom
		Vector(sourceArray:Object):Vector.<T> Tworzy nową instancję Vector, której elementy są instancjami określonego typu danych.	Najwyższy poziom
		XML(expression:Object):XML Konwertuje obiekt na obiekt XML.	Najwyższy poziom
		XMLList(expression:Object):XMLList Konwertuje obiekt na obiekt XMLList.	Najwyższy poziom

Stałe najwyższego poziomu (globalne) są dostępne w każdym skrypcie i widoczne na każdej osi czasu i w każdym zasięgu w dokumencie.

Stałe globalne

	Stała		Zdefiniowane przez
		Infinity : Number Wartość specjalna reprezentująca dodatnią nieskończoność.	Najwyższy poziom
		-Infinity : Number Wartość specjalna reprezentująca ujemną nieskończoność.	Najwyższy poziom
		NaN : Number Specjalny element typu danych Number, który reprezentuje wartość nieliczbową (NaN).	Najwyższy poziom
		undefined : * Wartość specjalna, która jest stosowana do niezainicjowanych zmiennych bez typu lub niezainicjowanych właściwości obiektów dynamicznych.	Najwyższy poziom

Szczegół stałej

-Infinity

Stała

public const -Infinity:Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

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

Powiązane elementy interfejsu API

Number.NEGATIVE_INFINITY

Przykład ( Sposób korzystania z tego przykładu )

Wynikiem dzielenia przez 0 będzie wartość -Infinity tylko w przypadku, gdy dzielnik jest liczbą ujemną.


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

Infinity

Stała

public const Infinity:Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

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

Powiązane elementy interfejsu API

Number.POSITIVE_INFINITY

Przykład ( Sposób korzystania z tego przykładu )

Wynikiem dzielenia przez 0 będzie wartość Infinity tylko w przypadku, gdy dzielnik jest liczbą dodatnią.


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

NaN

Stała

public const NaN:Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

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

isNaN()
Number.NaN

undefined

Stała

public const undefined:*

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

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

null

Przykład ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje, jak zmienna myVar bez typu jest deklarowana, ale nie inicjowana. Wartość zmiennej myVar to undefined, ponieważ zmienna nie posiada typu. Jest to prawda w przypadku, gdy zmienna nie posiada opisu typu lub wykorzystuje specjalny nieposiadający typu opis (*) (var myVar:*;).


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

Ta sama reguła ma zastosowanie do niezainicjowanych właściwości obiektu dynamicznego. Przykład: Dla instancji obj dynamicznej klasy A wartość właściwości obj.propName, która stanowi niezainicjowaną właściwość instancji obj to wartość undefined.


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

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

Szczegół funkcji

Array

()

funkcja

public function Array(... args):Array

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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.

Efekt działania funkcji Array() jest podobny do utworzenia tablicy za pomocą konstruktora klasy Array, ale funkcja Array() umożliwia tylko użycie jednej wartości parametru lub pominięcie parametru. Funkcja Array() nie pozwala wypełnić nowej tablicy wieloma wartościami.

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

... args — Można nie przekazywać argumentów, aby uzyskać pustą tablicę, przekazać jeden argument będący liczbą całkowitą w celu utworzenia tablicy o określonej długości albo przekazać pojedynczy obiekt, co spowoduje utworzenie tablicy zawierającej ten obiekt.

Zwraca

Array — Tablica, której długość jest określona wartością zero lub większą.

Powiązane elementy interfejsu API

klasa Array
jako operator

Przykład ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje zachowanie funkcji Array(), jeśli argument nie jest wartością pierwotną. Częstym przypadkiem wykorzystania rzutowania na tablicę jest konwersja instancji klasy Object, która zawiera wartości w formie tablicy. W przypadku wywołania funkcji Array() z argumentem typu Object lub innymi danymi, które nie są wartościami pierwotnymi w elemencie nowej tablicy przechowywane jest odwołanie do obiektu. Innymi słowy, jeśli jedynym przekazanym argumentem jest obiekt, odwołanie to tego obiektu staje się pierwszym elementem nowej tablicy.

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

Rzutowania obiektu obj na tablicę można dokonać za pomocą operatora as, który zwraca odwołanie do tablicy, jeśli argument obj stanowi poprawą tablicę. W przeciwnym razie zwracana jest wartość null:

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

Boolean

()

funkcja

public function Boolean(expression:Object):Boolean

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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:

Wartość wejściowa	Przykład	Wartość zwrócona
`0`	`Boolean(0)`	`false`
`NaN`	`Boolean(NaN)`	`false`
Number (nie `0` lub `NaN`)	`Boolean(4)`	`true`
Pusty ciąg znaków	`Boolean("")`	`false`
Niepusty ciąg znaków	`Boolean("6")`	`true`
`null`	`Boolean(null)`	`false`
`undefined`	`Boolean(undefined)`	`false`
Instancja klasy Object	`Boolean(new Object())`	`true`
Bez argumentu	`Boolean()`	`false`

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

Parametry

expression:Object — Wyrażenie lub obiekt konwertowany na wartość typu Boolean.

Zwraca

Boolean — Rezultat konwersji na wartość typu Boolean.

decodeURI

()

funkcja

public function decodeURI(uri:String):String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Sekwencje zmiany znaczenia, które nie są dekodowane	Odpowiedniki znaków
`%23`	`#`
`%24`	`$`
`%26`	`&`
`%2B`	`+`
`%2C`	`,`
`%2F`	`/`
`%3A`	`:`
`%3B`	`;`
`%3D`	`=`
`%3F`	`?`
`%40`	`@`

Parametry

uri:String — Ciąg znaków zakodowany za pomocą funkcji encodeURI.

Zwraca

String — Ciąg znaków, w których wszystkie znaki zmienione za pomocą funkcji encodeURI zostały przywrócone do swojej reprezentacji przed zmianą.

Powiązane elementy interfejsu API

decodeURIComponent()
encodeURI()
encodeURIComponent()

Przykład ( Sposób korzystania z tego przykładu )

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

decodeURIComponent

()

funkcja

public function decodeURIComponent(uri:String):String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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

uri:String — Ciąg znaków zakodowany z pomocą funkcji encodeURIComponent.

Zwraca

String — Ciąg znaków, w których wszystkie znaki zmienione za pomocą funkcji encodeURIComponent zostały przywrócone do swojej reprezentacji przed zmianą.

Powiązane elementy interfejsu API

decodeURI()
encodeURI()
encodeURIComponent()

encodeURI

()

funkcja

public function encodeURI(uri:String):String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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.

Znaki niekodowane
`0 1 2 3 4 5 6 7 8 9`
`a b c d e f g h i j k l m n o p q r s t u v w x y z`
`A B C D E F G H I J K L M N O P Q R S T U V W X Y Z`
`; / ? : @ & = + $ , #`
`- _ . ! ~ * ' ( )`

Parametry

uri:String — Ciąg znaków reprezentujący pełny identyfikator URI.

Zwraca

String — Ciąg zawierający określone znaki zakodowane jako sekwencje zmiany znaczenia UTF-8.

Powiązane elementy interfejsu API

decodeURI()
decodeURIComponent()
encodeURIComponent()

Przykład ( Sposób korzystania z tego przykładu )

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

encodeURIComponent

()

funkcja

public function encodeURIComponent(uri:String):String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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.

Znaki niekodowane
`0 1 2 3 4 5 6 7 8 9`
`a b c d e f g h i j k l m n o p q r s t u v w x y z`
`A B C D E F G H I J K L M N O P Q R S T U V W X Y Z`
`- _ . ! ~ * ' ( )`

Parametry

uri:String

Zwraca

String

Powiązane elementy interfejsu API

decodeURI()
decodeURIComponent()
encodeURI()

escape

()

funkcja

public function escape(str:String):String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Znaki niekodowane
`0 1 2 3 4 5 6 7 8 9`
`a b c d e f g h i j k l m n o p q r s t u v w x y z`
`A B C D E F G H I J K L M N O P Q R S T U V W X Y Z`
`@ - _ . * + /`

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

Parametry

str:String — Wyrażenie konwertowane na ciąg znaków i kodowane w formacie adresu URL.

Zwraca

String — Ciąg znaków zakodowany w formacie adresu URL.

Powiązane elementy interfejsu API

unescape()
encodeURIComponent()

int

()

funkcja

public function int(value:Number):int

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Parametry

value:Number — Wartość konwertowana na liczbę całkowitą.

Zwraca

int — Konwertowana wartość liczby całkowitej.

Powiązane elementy interfejsu API

uint()

isFinite

()

funkcja

public function isFinite(num:Number):Boolean

Wersja języka:

ActionScript 3.0.

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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

num:Number — Liczba określana jako liczba skończona lub nieskończoność.

Zwraca

Boolean — W przypadku liczby skończonej zwraca wartość true. W przypadku wartości nieskończoności lub minus nieskończoności zwraca wartość false

isNaN

()

funkcja

public function isNaN(num:Number):Boolean

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Typ wejściowy/Wartość wejściowa	Przykład	Wartość zwrócona
0 dzielone przez 0	`isNaN(0/0)`	`true`
Liczba, która nie jest zerem, dzielona przez `0`	`isNaN(5/0)`	`false`
Pierwiastek kwadratowy z liczby ujemnej	`isNaN(Math.sqrt(-1))`	`true`
Arcus sinus liczby większej od 1 lub mniejszej od 0	`isNaN(Math.asin(2))`	`true`
Ciąg znaków, który można konwertować na typ Number	`isNaN("5")`	`false`
Ciąg znaków, którego nie można konwertować na typ Number	`isNaN("5a")`	`true`

Parametry

num:Number — Analizowana wartość liczbowa lub wyrażenie matematyczne.

Zwraca

Boolean — Dla wartości NaN (nie liczba) zwraca wartość true. W przeciwnym razie zwraca wartość false.

isXMLName

()

funkcja

public function isXMLName(str:String):Boolean

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Parametry

str:String — Analizowany ciąg danych.

Zwraca

Boolean — Jeśli argument str stanowi poprawna nazwę XML, zwraca wartość true. W przeciwnym razie zwraca wartość false.

Number

()

funkcja

public function Number(expression:Object):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Typ wejściowy/Wartość wejściowa	Przykład	Wartość zwrócona
`undefined`	`Number(undefined)`	`NaN`
`null`	`Number(null)`	`0`
`true`	`Number(true)`	`1`
`false`	`Number(false)`	`0`
`NaN`	`Number(NaN)`	`NaN`
Pusty ciąg	`Number("")`	`0`
Ciąg znaków konwertowany na typ Number	`Number("5")`	Liczba (np. `5`)
Ciąg, którego nie można przekonwertować na typ Number	`Number("5a")`	`NaN`

Parametry

expression:Object — Wartość konwertowana na liczbę.

Zwraca

Number — Konwertowana wartość liczbowa

Object

()

funkcja

public function Object(value:Object):Object

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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

value:Object — Konwertowany obiekt, liczba, ciąg znaków lub wartość typu Boolean.

Zwraca

Object — Wartość określona przez parametr value.

parseFloat

()

funkcja

public function parseFloat(str:String):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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

str:String — Ciąg znaków odczytywany i konwertowany na liczbę zmiennoprzecinkową.

Zwraca

Number — Liczba lub wartość NaN (nie liczba).

parseInt

()

funkcja

public function parseInt(str:String, radix:uint = 0):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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

	`str:String` — Ciąg znaków konwertowany na liczbę całkowitą.

	`radix:uint` (default = `0`) — Liczba całkowita reprezentująca podstawę analizowanej składniowo liczby. Wartości poprawne należą do zakresu od 2 do 36.

Zwraca

Number — Liczba lub wartość NaN (nie liczba).

String

()

funkcja

public function String(expression:Object):String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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

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

Typ wejściowy/Wartość wejściowa	Wartość zwrócona
`undefined`	`undefined`
`null`	`"null"`
`true`	`"true"`
`false`	`"false"`
`NaN`	`"NaN"`
String	String
Object	Object.toString()
Number	Ciąg znaków reprezentujący liczbę

Parametry

expression:Object — Wyrażenie konwertowane na ciąg znaków.

Zwraca

String — Ciąg znaków reprezentujący wartość przekazaną do parametru expression.

trace

()

funkcja

public function trace(... arguments):void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0, Flash Lite 4

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

... arguments — Jedno lub więcej analizowanych wyrażeń (oddzielonych przecinkiem). W przypadku wielu wyrażeń ich wyniki oddzielane są spacją.

Przykład ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje użycie klasy TraceExample w celu pokazania sposobu, w jaki można użyć metody trace(), aby wydrukować prosty ciąg znaków. Zwykle taki komunikat jest drukowany w przypadku Konsoli debugowania.

package {
    import flash.display.Sprite;

    public class TraceExample extends Sprite {

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

uint

()

funkcja

public function uint(value:Number):uint

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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.

Typ wejściowy/Wartość wejściowa	Przykład	Wartość zwrócona
`undefined`	`uint(undefined)`	`0`
`null`	`uint(null)`	`0`
`0`	`uint(0)`	`0`
`NaN`	`uint(NaN)`	`0`
Dodatnia liczba zmiennoprzecinkowa	`uint(5.31)`	Przycięta liczba całkowita bez znaku (np. `5`)
Ujemna liczba zmiennoprzecinkowa	`uint(-5.78)`	Przycina do liczby całkowitej, a następnie stosuje zasadę dla ujemnych liczb całkowitych
Ujemna liczba całkowita	`uint(-5)`	Suma wartości `uint.MAX_VALUE` oraz ujemnej liczby całkowitej (na przykład `uint.MAX_VALUE + (-5)`)
`true`	`uint(true)`	`1`
`false`	`uint(false)`	`0`
Pusty ciąg znaków	`uint("")`	`0`
Ciąg znaków konwertowany na typ Number	`uint("5")`	Liczba
Ciąg znaków, którego nie można konwertować na typ Number	`uint("5a")`	`0`

Parametry

value:Number — Wartość konwertowana na liczbę całkowitą.

Zwraca

uint — Konwertowana wartość liczby całkowitej.

Powiązane elementy interfejsu API

int()

unescape

()

funkcja

public function unescape(str:String):String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

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

str:String — Ciąg znaków zawierający zmieniane sekwencje szesnastkowe.

Zwraca

String — Ciąg zdekodowany z parametru w formacie adresu URL.

Vector

()

funkcja

public function Vector(sourceArray:Object):Vector.<T>

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, Flash Lite 4

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

sourceArray:Object — Obiekt Array lub instancja Vector, którego elementy stają się elementami wynikowej instancji Vector. Jeśli argument stanowi instancję Vector, której skojarzony typ danych jest taki sam, jak określony typ danych, zwróconym wynikiem funkcji będzie ten argument.

Zwraca

Vector.<T> — Instancja Vector zapełniona elementami tablicy sourceArray.

Zgłasza

TypeError — Jeśli argument sourceArray zawiera element, którego nie można konwertować na określony typ danych.

Powiązane elementy interfejsu API

Klasa Vector

XML

()

funkcja

public function XML(expression:Object):XML

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Konwertuje obiekt na obiekt XML.

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

Typ parametru	Wartość zwrócona
Boolean	W pierwszej kolejności wartość jest konwertowana na ciąg, a następnie na obiekt XML.
Null	Pojawia się błąd środowiska wykonawczego (wyjątek TypeError).
Number	W pierwszej kolejności wartość jest konwertowana na ciąg znaków, a następnie na obiekt XML.
Object	Konwertuje jedynie na obiekt XML, jeśli jest to wartość typu String, Number lub Boolean. W przeciwnym razie pojawia się błąd środowiska wykonawczego (wyjątek TypeError).
String	Wartość konwertowana na obiekt XML.
Undefined	Występuje błąd środowiska wykonawczego (wyjątek TypeError).
XML	Zwracana jest niezmieniona wartość wejściowa.
XMLList	Zwraca jedynie obiekt XML, jeśli obiekt XMLList zawiera tylko jedną właściwość typu XML. W przeciwnym razie występuje błąd środowiska wykonawczego (wyjątek TypeError).

Parametry

expression:Object — Obiekt konwertowany na obiekt XML.

Zwraca

XML — Obiekt XML zawierający wartości obiektu konwertowanego.

Powiązane elementy interfejsu API

XMLList()

XMLList

()

funkcja

public function XMLList(expression:Object):XMLList

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Konwertuje obiekt na obiekt XMLList.

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

Typ parametru	Wartość zwrócona
Boolean	W pierwszej kolejności wartość jest konwertowana na ciąg znaków, a następnie na obiekt XMLList.
Null	Pojawia się błąd środowiska wykonawczego (wyjątek TypeError).
Number	W pierwszej kolejności wartość jest konwertowana na ciąg, a następnie na obiekt XMLList.
Object	Konwertuje jedynie na obiekt XMLList, jeśli jest to wartość typu String, Number lub Boolean. W przeciwnym razie pojawia się błąd środowiska wykonawczego (wyjątek TypeError).
String	Wartość jest konwertowana na obiekt XMLList.
Undefined	Występuje błąd środowiska wykonawczego (wyjątek TypeError).
XML	Wartość jest konwertowana na obiekt XMLList.
XMLList	Zwracana jest niezmieniona wartość wejściowa.

Parametry

expression:Object — Obiekt konwertowany na obiekt XMLList.

Zwraca

XMLList — Obiekt XMLList zawierający wartości konwertowanego obiektu.

Powiązane elementy interfejsu API

XML()

Informacje prawne | Zasady prywatności online

Najwyższy poziom

Klasy x

-Infinity

Infinity

NaN

undefined

Array

Boolean

decodeURI

decodeURIComponent

encodeURI

encodeURIComponent

escape

int

isFinite

isNaN

isXMLName

Number

Object

parseFloat

parseInt

String

trace

uint

unescape

Vector

XML

XMLList