Funktionen der obersten Ebene (globale Funktionen) stehen in jedem Teil einer SWF-Datei, in dem ActionScript verwendet wird, oder in jeder benutzerdefinierten Klasse zur Verfügung. Die meisten globalen Funktionen von ActionScript 2.0 wurden in Klassen migriert.
Funktion | Definiert von | ||
---|---|---|---|
Erstellt ein neues Array. | Oberste Ebene | ||
Wandelt den Parameter „expression“ in einen booleschen Wert um und gibt diesen Wert zurück. | Oberste Ebene | ||
Dekodiert einen kodierten URI in einen String. | Oberste Ebene | ||
Dekodiert eine kodierte URI-Komponente in einen String. | Oberste Ebene | ||
Kodiert einen String in einen gültigen URI (Uniform Resource Identifier, einheitlicher Ressourcenbezeichner). | Oberste Ebene | ||
Kodiert einen String in eine gültige URI-Komponente. | Oberste Ebene | ||
Wandelt den Parameter in einen String um und kodiert ihn in einem URL-Format, bei dem die meisten nicht alphanumerischen Zeichen als %, gefolgt von einer Hexadezimalsequenz, dargestellt werden. | Oberste Ebene | ||
Konvertiert einen bestimmten numerischen Wert in eine Ganzzahl. | Oberste Ebene | ||
Gibt true zurück, wenn der Wert eine endliche Zahl ist und false, wenn der Wert Infinity oder -Infinity ist. | Oberste Ebene | ||
Gibt „true“ zurück, wenn der Wert „NaN“ (Not a Number – keine Zahl) lautet. | Oberste Ebene | ||
Bestimmt, ob der angegebene String ein gültiger Name für ein XML-Element oder -Attribut ist. | Oberste Ebene | ||
Konvertiert einen bestimmten Wert in einen Number-Wert. | Oberste Ebene | ||
Jeder Wert in ActionScript 3.0 ist ein Objekt, d. h., wenn Sie für einen Wert Object() aufrufen, wird dieser Wert zurückgegeben. | Oberste Ebene | ||
Wandelt einen String in eine Gleitkommazahl um. | Oberste Ebene | ||
Wandelt einen String in eine Ganzzahl um. | Oberste Ebene | ||
Gibt den angegebenen Parameter als String zurück. | Oberste Ebene | ||
Zeigt während der Fehlersuche Ausdrücke an oder schreibt sie in Protokolldateien. | Oberste Ebene | ||
Konvertiert einen bestimmten numerischen Wert in eine vorzeichenlose Ganzzahl. | Oberste Ebene | ||
Wertet den Parameter str als String aus, dekodiert den String aus dem URL-Format (indem er alle Hexadezimalsequenzen in ASCII-Zeichen konvertiert) und gibt den String zurück. | Oberste Ebene | ||
Erstellt eine neue Vector-Instanz, deren Elemente Instanzen des festgelegten Datentyps sind. | Oberste Ebene | ||
Konvertiert ein Objekt in ein XML-Objekt. | Oberste Ebene | ||
Konvertiert ein Objekt in ein XMLList-Objekt. | Oberste Ebene |
Konstanten der obersten Ebene (globale Konstanten) stehen in jedem Skript zur Verfügung und sind für jede Zeitleiste und jeden Gültigkeitsbereich in Ihrem Dokument sichtbar.
Konstante | Definiert von | ||
---|---|---|---|
Infinity : Number
Ein spezieller Wert, der eine positive Infinity repräsentiert. | Oberste Ebene | ||
-Infinity : Number
Ein spezieller Wert, der eine negative Infinity repräsentiert. | Oberste Ebene | ||
NaN : Number
Ein spezielles Mitglied des Datentyps Number, das einen Wert repräsentiert der „not a number“, also keine Zahl, ist (NaN). | Oberste Ebene | ||
undefined : *
Ein spezieller Wert, der auf nicht typisierte Variablen angewendet wird, die nicht initialisiert worden sind, oder auf dynamische Objekteigenschaften, die nicht initialisiert werden. | Oberste Ebene |
-Infinity | Konstante |
public const -Infinity:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Ein spezieller Wert, der eine negative Infinity
repräsentiert. Der Wert dieser Konstante entspricht Number.NEGATIVE_INFINITY
.
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
-Infinity
, wenn der Divisor ein negative Zahl ist.
trace(0 / 0); // NaN trace(7 / 0); // Infinity trace(-7 / 0); // -Infinity
Infinity | Konstante |
public const Infinity:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Ein spezieller Wert, der eine positive Infinity
repräsentiert. Der Wert dieser Konstante entspricht Number.POSITIVE_INFINITY
.
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
Infinity
, wenn der Divisor ein positive Zahl ist.
trace(0 / 0); // NaN trace(7 / 0); // Infinity trace(-7 / 0); // -Infinity
NaN | Konstante |
public const NaN:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Ein spezielles Mitglied des Datentyps Number, das einen Wert repräsentiert der „not a number“, also „keine Zahl“, ist (NaN
). Wenn ein mathematischer Ausdruck einen Wert ergibt, der nicht als Zahl ausgedrückt werden kann, ist das Ergebnis NaN
. Die folgende Liste beschreibt häufig vorkommende Ausdrücke, die das Ergebnis NaN
liefern.
- Eine Division durch 0 resultiert nur dann in dem Wert
NaN
, wenn der Divisor ebenfalls 0 ist. Ist der Divisor größer als 0, resultiert die Division durch 0 in dem Wert
. Ist der Divisor kleiner 0, resultiert die Division durch 0 in dem WertInfinity
.-Infinity
- Die Quadratwurzel aus einer negativen Zahl.
- Der Arkussinus einer Zahl, die außerhalb des zulässigen Bereichs von 0 bis 1 liegt.
Infinity
subtrahiert vonInfinity
;Infinity
oder-Infinity
geteilt durchInfinity
oder-Infinity
;Infinity
oder-Infinity
mit 0 multipliziert;
Der Wert NaN
ist kein Mitglied der Datentypen int oder uint.
Der Wert NaN
wird nicht als identisch mit einem anderen Wert betrachtet, einschließlich NaN
, d. h., es ist unmöglich, den Gleichheitsoperator darauf anzuwenden, um festzustellen, ob ein Ausdruck NaN
ist. Um festzustellen, ob eine Zahl die Funktion NaN
ist, verwenden Sie isNaN()
.
Verwandte API-Elemente
undefined | Konstante |
public const undefined:*
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Ein spezieller Wert, der auf nicht typisierte Variablen angewendet wird, die nicht initialisiert worden sind, oder auf dynamische Objekteigenschaften, die nicht initialisiert werden. In ActionScript 3.0 können nur nicht typisierte Variablen den Wert undefined
besitzen, was in ActionScript 1.0 und ActionScript 2.0 noch anders war. So sind beispielsweise beide der folgenden Variablen undefined
, da sie nicht typisiert und nicht initialisiert sind:
var foo;
var bar:*;
Der Wert undefined
trifft auch auf nicht initialisierte und oder nicht definierte Eigenschaften von dynamischen Objekten zu. Ist ein Objekt beispielsweise eine Instanz der Object-Klasse, ist der Wert jeglicher dynamisch hinzugefügter Eigenschaft undefined
, bis er dieser Eigenschaft zugewiesen wird.
Bei verschiedenen Funktionen ist das Ergebnis bei der Verwendung von undefined
unterschiedlich:
- Der von
String(undefined)
zurückgegebene Wert ist"undefined"
(undefined
wird in einen String konvertiert). - Der von
Number(undefined)
zurückgegebene Wert istNaN
. - Der von
int(undefined)
unduint(undefined)
zurückgegebene Wert ist 0. - Der von
Object(undefined)
zurückgegebene Wert ist eine neue Object-Instanz. - Wird der Wert
undefined
einer typisierten Variable zugewiesen, wird er in den Standardwert des betreffenden Datentyps umgewandelt.
Verwechseln Sie undefined
nicht mit null
. Wenn null
und undefined
anhand des Gleichheitsoperators (==
) verglichen werden, gelten sie als identisch. Wenn null
und undefined
dagegen mit dem Operator für strikte Gleichheit (===
) verglichen werden, sind sie nicht identisch.
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
myVar
) deklariert aber nicht initialisiert. Der Wert von myVar
ist undefined
, da es sich um eine nicht typisiert Variable handelt. Dies trifft immer dann zu, wenn die Variable keine Typanmerkung aufweist oder das Asterisk-Symbol (*) entspricht keiner Typanmerkung verwendet (var myVar:*;
).
// trace value of untyped and uninitialized variable var myVar; trace(myVar); // undefined
obj
der dynamischen Klasse A
der Wert von obj.propName
, wobei es sich um eine nicht initialisierte Eigenschaft der obj
-Instanz handelt, undefined
.
dynamic class A {} var obj:A = new A() // trace undefined property of obj trace(obj.propName); // undefined
Array | () | Funktion |
public function Array(... args):Array
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Erstellt ein neues Array. Das Array kann eine Länge von null oder mehr aufweisen, oder es kann sich um ein Array handeln, das mit einem einzelnen, angegebenen Objekt gefüllt ist.
- Wenn Sie
Array()
ohne Argumente aufrufen, wird ein leeres Array zurückgegeben. - Wenn Sie
Array()
mit einem einzigen, ganzzahligen Argument aufrufen, wird ein Array der angegebenen Länge zurückgegeben, für dessen Elemente aber keine Werte definiert sind. - Beim Aufruf von
Array()
mit einem angegebenen Objekt wird ein Array mit einem Element des angegebenen Objekts zurückgegeben.
Array()
-Funktion ähnelt dem Erstellen eines Arrays mit dem Array-Klassenkonstruktor, allerdings lässt die Array()
-Funktion nur einen oder keine Parameterwerte zu. Mit der Array()
-Funktion können Sie das neue Array nicht mit verschiedenen Werten füllen.
Hinweis: Wenn Sie versuchen, mit der Array()
-Funktion ein neues Array zu erstellen und verschiedene Werte als Parameter übergeben, um das Array zu füllen, wird ein Compilerfehler ausgegeben. Die Array()
-Funktion lässt nur einen Parameter zu. Verwenden Sie stattdessen den Array-Klassenkonstruktor, um ein Array zu erstellen und mit mehreren Werten zu füllen.
Die Array()
-Funktion übernimmt den Typ eines Objekts nicht für ein Array. Mithilfe des Operators as
können Sie eine ausdrückliche Datentypumwandlung oder -konvertierung festlegen, wenn das Argument kein Grundwert ist. Weitere Informationen finden Sie unten im Abschnitt „Beispiel“. Wenn Sie ein Objekt als Parameter an die Array()
-Funktion übergeben, wird ein neues Array erstellt, das das Objekt als Element enthält.
Parameter
... args — Sie können: keine Argumente für ein leeres Array, ein einzelnes Integer-Argument für ein Array bestimmter Länge, oder ein einzelnes Objekt zum Erstellen eines Arrays mit diesem einen Objekt übergeben.
|
Array — Ein Array mit einer Länge von mindestens 0.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
Array()
, wenn es sich bei einem Argument nicht um einen Grundwert handelt. Die Umwandlung in ein Array wird häufig verwendet, wenn eine Objektinstanz umgewandelt wird, deren Werte im Array-Format gespeichert werden. Wenn Array()
mit einem Argument vom Typ Object
oder einem anderen Datentyp, bei dem es sich nicht um Grundwerte handelt, aufgerufen wird, wird ein Verweis auf das Objekt in einem Element des neuen Arrays gespeichert. Anders ausgedrückt: Wenn als einziges Argument ein Objekt übergeben wird, wird ein Verweis auf dieses Objekt das erste Element des neuen Arrays.
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
obj
in ein Array umzuwandeln, verwenden Sie den Operator as
. Es wird ein Array-Verweis zurückgegeben, wenn es sich beiobj
um einen gültigen Array handelt; anderfalls 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 | () | Funktion |
public function Boolean(expression:Object):Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wandelt den Parameter expression
in einen booleschen Wert um und gibt diesen Wert zurück.
Der Rückgabewert hängt, wie in der folgenden Tabelle beschrieben, vom Datentyp und Wert des Arguments ab:
Eingabewert | Beispiel | Rückgabewert |
---|---|---|
0 | Boolean(0) | false |
NaN | Boolean(NaN) | false |
Number (nicht 0 oder NaN ) | Boolean(4) | true |
Leerer String | Boolean("") | false |
Nicht leerer String | Boolean("6") | true |
„null“ | Boolean(null) | false |
undefined | Boolean(undefined) | false |
Instanz der Object-Klasse | Boolean(new Object()) | true |
Kein Argument | Boolean() | false |
Im Gegensatz zu früheren ActionScript-Versionen gibt die Funktion Boolean()
dasselbe Ergebnis zurück wie der Klassenkonstruktor Boolean.
Parameter
expression:Object — Ein in den Datentyp Boolean zu konvertierender Ausdruck oder eine Objekt.
|
Boolean — Das Ergebnis der Umwandlung in den Datentyp Boolean.
|
decodeURI | () | Funktion |
public function decodeURI(uri:String):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Dekodiert einen kodierten URI in einen String. Gibt einen String zurück, in dem alle zuvor von der Funktion encodeURI
kodierten Zeichen wieder in ihre unkodierte Darstellung zurückversetzt werden.
Die folgende Tabelle zeigt den Satz an Escape-Sequenzen, die nicht von der Funktion decodeURI
in Zeichen dekodiert werden. Um die Escape-Sequenzen in dieser Tabelle zu dekodieren, verwenden Sie decodeURIComponent()
.
Nicht dekodierte Escape-Sequenzen | Zeichenentsprechungen |
---|---|
%23 | # |
%24 | $ |
%26 | & |
%2B | + |
%2C | , |
%2F | / |
%3A | : |
%3B | ; |
%3D | = |
%3F | ? |
%40 | @ |
Parameter
uri:String — Ein mit der Funktion encodeURI kodierter String.
|
String — Ein String, in dem alle zuvor von der Funktion encodeURI mit Escape-Sequenzen versehenen Zeichen wieder in die Darstellung ohne Escape-Sequenzen zurückversetzt werden.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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 | () | Funktion |
public function decodeURIComponent(uri:String):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Dekodiert eine kodierte URI-Komponente in einen String. Gibt einen String zurück, in dem alle zuvor von der Funktion encodeURIComponent
mit Escape-Sequenzen versehenen Zeichen wieder in ihre unkodierte Darstellung zurück versetzt werden.
Diese Funktion unterscheidet sich in so fern von der Funktion decodeURI()
als sie für die Verwendung mit nur einem Teil des URI-Strings, einer sogenannten URI-Komponente, konzipiert ist. Eine URI-Komponente ist ein beliebiger Text, der zwischen speziellen Zeichen, den sogenannten component separators, erscheint : ( / ; und ?
). Gewöhnliche Beispiele für URI-Komponenten sind „http“ oder „www.adobe.com“.
Ein weiterer wichtiger Unterschied zwischen dieser Funktion und decodeURI()
ist, dass diese Funktion davon ausgeht, dass sie eine URI-Komponente verarbeitet, und somit die Escape-Sequenzen, die spezielle Trennzeichen repräsentieren (; / ? : @ & = + $ , #
) als regulären Text behandelt, der dekodiert werden soll.
Parameter
uri:String — Ein mit der Funktion encodeURIComponent kodierter String.
|
String — Ein String, in dem alle zuvor von der Funktion encodeURIComponent mit Escape-Sequenzen versehenen Zeichen wieder in die Darstellung ohne Escape-Sequenzen zurückversetzt werden.
|
Verwandte API-Elemente
encodeURI | () | Funktion |
public function encodeURI(uri:String):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Kodiert einen String in einen gültigen URI (Uniform Resource Identifier, einheitlicher Ressourcenbezeichner). Konvertiert einen vollständigen URI in einen String, in dem alle Zeichen, bis auf eine kleine Gruppe von Standardzeichen, als UTF-8-Escape-Sequenzen kodiert werden.
Die folgende Tabelle zeigt den gesamten Satz an Standardzeichen, die nicht von der Funktion encodeURI
in UTF-8-Escape-Sequenzen konvertiert werden.
Nicht kodierte Zeichen |
---|
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 |
; / ? : @ & = + $ , # |
- _ . ! ~ * ' ( ) |
Parameter
uri:String — Ein String, der einen vollständigen URI repräsentiert.
|
String — Ein String, in dem bestimmte Zeichen als UTF-8-Escape-Sequenzen kodiert sind.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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 | () | Funktion |
public function encodeURIComponent(uri:String):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Kodiert einen String in eine gültige URI-Komponente. Konvertiert einen Teilstring eines URI in einen String, in dem alle Zeichen, bis auf eine kleine Gruppe von Standardzeichen, als UTF-8-Escape-Sequenzen kodiert werden.
Die Funktion encodeURIComponent()
unterscheidet sich in so fern von der Funktion encodeURI()
, als sie für die Verwendung mit nur einem Teil eines URI-Strings, einer sogenannten URI-Komponente, konzipiert ist. Eine URI-Komponente ist ein beliebiger Text, der zwischen speziellen Zeichen, den sogenannten component separators, erscheint : ( / ; und ?
). Gewöhnliche Beispiele für URI-Komponenten sind „http“ oder „www.adobe.com“.
Ein weiterer wichtiger Unterschied zwischen dieser Funktion und encodeURI()
ist, dass diese Funktion davon ausgeht, dass sie eine URI-Komponente verarbeitet, und somit die speziellen Trennzeichen (; / ? : @ & = + $ , #
) als regulären Text behandelt, der kodiert werden soll.
Die folgende Tabelle zeigt alle Zeichen, die nicht von der Funktion encodeURIComponent
in UTF-8-Escape-Sequenzen konvertiert werden.
Nicht kodierte Zeichen |
---|
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 |
- _ . ! ~ * ' ( ) |
Parameter
uri:String |
String |
Verwandte API-Elemente
escape | () | Funktion |
public function escape(str:String):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wandelt den Parameter in einen String um und kodiert ihn in ein URL-Format, bei dem die meisten nicht alphanumerischen Zeichen durch ein %
, gefolgt von einer Hexadezimalsequenz, ersetzt werden. Bei URL-kodierten Strings dient das Prozentzeichen (%
) zum Maskieren von Escape-Zeichen und entspricht nicht dem Modulo-Operator (%
).
Die folgende Tabelle zeigt alle Zeichen, die nicht von der Funktion escape()
in Escape-Sequenzen konvertiert werden.
Nicht kodierte Zeichen |
---|
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 |
@ - _ . * + / |
Hinweis: Verwenden Sie die encodeURIComponent()
-Funktion statt der escape()
-Funktion, damit Sondertrennzeichen (@ + /
) als regulärer, zu kodierender Text behandelt werden.
Parameter
str:String — Der Ausdruck, der in einen String umgewandelt und in das URL-Format kodiert werden soll.
|
String — Ein als URL kodierter String
|
Verwandte API-Elemente
int | () | Funktion |
public function int(value:Number):int
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Konvertiert einen bestimmten numerischen Wert in eine Ganzzahl. Dezimalwerte werden an der Dezimalstelle abgeschnitten.
Parameter
value:Number — Ein Wert, der in eine Ganzzahl umgewandelt werden soll.
|
int — Die konvertierte Ganzzahl.
|
Verwandte API-Elemente
isFinite | () | Funktion |
public function isFinite(num:Number):Boolean
Sprachversion: | ActionScript 3.0. |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt true
zurück, wenn der Wert eine endliche Zahl ist und false
, wenn der Wert Infinity
oder -Infinity
ist. Das Auftreten von Infinity
oder -Infinity
deutet auf einen mathematischen Fehlerzustand hin, beispielsweise eine Division durch 0.
Parameter
num:Number — Eine Zahl, die als endlich oder unendlich ausgewertet wird.
|
Boolean — Gibt true zurück, wenn es sich um eine endliche Zahl handelt, bzw. false , wenn es sich um positive oder negative Unendlichkeit handelt
|
isNaN | () | Funktion |
public function isNaN(num:Number):Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt true
zurück, wenn der Wert NaN
(Not a Number – keine Zahl) lautet. Die Funktion isNaN()
dient zur Überprüfung, ob ein mathematischer Ausdruck erfolgreich als Zahl ausgewertet werden kann. Die häufigste Verwendung von isNaN()
ist die Überprüfung des Werts, der von der parseInt()
- und der parseFloat()
-Funktion zurückgegeben wird. Der Wert NaN
ist ein spezielles Mitglied des Datentyps Number, das einen Wert repräsentiert der „not a number“, also keine Zahl, ist.
Hinweis: Der Wert NaN
ist kein Mitglied der Datentypen „int“ oder „uint“.
Die folgende Tabelle beschreibt den Rückgabewert von isNaN()
bei verschiedenen Eingabetypen und -werten. (Wenn für Compilerwarnungen der Strict-Modus festgelegt ist, führen einige der folgenden Vorgänge zu Compilerwarnungen.)
Eingabetyp/-wert | Beispiel | Rückgabewert |
---|---|---|
0 durch 0 dividiert | isNaN(0/0) | true |
Eine Zahl ungleich Null durch 0 dividiert | isNaN(5/0) | false |
Quadratwurzel aus einer negativen Zahl | isNaN(Math.sqrt(-1)) | true |
Arkussinus einer Zahl, die größer als 1 oder kleiner als 0 ist | isNaN(Math.asin(2)) | true |
String, der in einen Number-Wert konvertiert werden kann | isNaN("5") | false |
String, der nicht in einen Number-Wert konvertiert werden kann | isNaN("5a") | true |
Parameter
num:Number — Ein zu berechnender numerischer oder mathematischer Ausdruck.
|
Boolean — Gibt true zurück, wenn der Wert NaN (Not a Number – keine Zahl) lautet; andernfalls false .
|
isXMLName | () | Funktion |
public function isXMLName(str:String):Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bestimmt, ob der angegebene String ein gültiger Name für ein XML-Element oder -Attribut ist.
Parameter
str:String — Ein auszuwertender String.
|
Boolean — Gibt true zurück, wenn das Argument str ein gültiger XML-Name ist; andernfalls false .
|
Number | () | Funktion |
public function Number(expression:Object):Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Konvertiert einen bestimmten Wert in einen Number-Wert. Die folgende Tabelle zeigt das Ergebnis verschiedener Eingabetypen:
Eingabetyp/-wert | Beispiel | Rückgabewert |
---|---|---|
undefined | Number(undefined) | NaN |
„null“ | Number(null) | 0 |
true | Number(true) | 1 |
false | Number(false) | 0 |
NaN | Number(NaN) | NaN |
Leerer String | Number("") | 0 |
String, der in einen Number-Wert konvertiert wird | Number("5") | Die Zahl (z. B. 5 ) |
String, der nicht in einen Number-Wert konvertiert wird | Number("5a") | NaN |
Parameter
expression:Object — Ein Wert, der in einen Number-Wert umgewandelt werden soll.
|
Number — Der konvertierte Number-Wert
|
Object | () | Funktion |
public function Object(value:Object):Object
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Jeder Wert in ActionScript 3.0 ist ein Objekt, d. h., wenn Sie für einen Wert Object()
aufrufen, wird dieser Wert zurückgegeben.
Parameter
value:Object — Ein Objekt oder eine umzuwandelnde Zahl, ein String oder ein boolescher Wert.
|
Object — Der von dem Parameter value angegebene Wert.
|
parseFloat | () | Funktion |
public function parseFloat(str:String):Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wandelt einen String in eine Gleitkommazahl um. Die Funktion liest bzw. analysiert die Zahlen im String und gibt diese zurück, bis der Parser auf ein Zeichen trifft, das nicht zur Ausgangszahl gehört. Wenn der String nicht mit einer Zahl beginnt, die analysiert werden kann, gibt parseFloat()
den Wert NaN
zurück. Leerzeichen vor gültigen Ganzzahlen werden ebenso ignoriert wie nachgestellte nicht numerische Zeichen.
Parameter
str:String — Der String, der gelesen und in eine Gleitkommazahl umgewandelt werden soll.
|
Number — Eine Zahl oder NaN (Not a Number – keine Zahl).
|
parseInt | () | Funktion |
public function parseInt(str:String, radix:uint = 0):Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wandelt einen String in eine Ganzzahl um. Wenn der in den Parametern angegebene String nicht in eine Zahl umgewandelt werden kann, gibt die Funktion NaN
zurück. Strings, die mit 0x beginnen, werden als Hexadezimalzahlen interpretiert. Im Gegensatz zu früheren ActionScript-Versionen werden Ganzzahlen, die mit 0 beginnen, nicht als Oktalzahlen interpretiert. Für Oktalzahlen müssen Sie die Grundzahl 8 angeben. Leerzeichen und Nullwerte vor gültigen Ganzzahlen werden ebenso ignoriert wie nachgestellte nicht numerische Zeichen.
Parameter
str:String — Ein String, der in eine Ganzzahl umgewandelt werden soll.
| |
radix:uint (default = 0 ) — Eine Ganzzahl, die die Grundzahl (Basis) der zu analysierenden Zahl darstellt. Zulässige Werte liegen zwischen 2 und 36.
|
Number — Eine Zahl oder NaN (Not a Number – keine Zahl).
|
String | () | Funktion |
public function String(expression:Object):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt den angegebenen Parameter als String zurück.
Die folgende Tabelle zeigt das Ergebnis verschiedener Eingabetypen:
Eingabetyp/-wert | Rückgabewert |
---|---|
undefined | undefined |
„null“ | "null" |
true | "true" |
false | "false" |
NaN | "NaN" |
String | String |
Object | Object.toString() |
Number | Die Stringdarstellung der Zahl |
Parameter
expression:Object — Ein Ausdruck, der in einen String umgewandelt werden soll.
|
String — Eine für den Parameter expression übergebene Stringdarstellung des Werts.
|
trace | () | Funktion |
public function trace(... arguments):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Zeigt während der Fehlersuche Ausdrücke an oder schreibt sie in Protokolldateien. Eine einzelne trace-Anweisung kann mehrere Argumente unterstützen. Enthält ein Argument in einer trace-Anweisung einen Datentyp, der kein String ist, ruft die trace-Funktion die zu diesem Datentyp gehörige toString()
-Methode auf. Ist das Argument beispielsweise ein boolescher Wert, so ruft die trace-Funktion Boolean.toString()
auf und zeigt den Rückgabewert an.
Parameter
... arguments — Einer oder mehrere (durch Kommas getrennte) auszuwertende Ausdrücke. Bei mehreren Ausdrücken wird in der Ausgabe zwischen die einzelnen Ausdrücke ein Leerzeichen gesetzt.
|
Beispiel ( Verwendung dieses Beispiels )
TraceExample
-Klasse veranschaulicht, wie Sie mit der trace()
-Methode einen einfachen String ausdrucken können. Im Allgemeinen wird die Meldung auf einer „Debug“-Konsole ausgedruckt.
package { import flash.display.Sprite; public class TraceExample extends Sprite { public function TraceExample() { trace("Hello World"); } } }
uint | () | Funktion |
public function uint(value:Number):uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Konvertiert einen bestimmten numerischen Wert in eine vorzeichenlose Ganzzahl. Dezimalwerte werden an der Dezimalstelle abgeschnitten.
Die folgende Tabelle beschreibt den Rückgabewert von uint()
bei verschiedenen Eingabetypen und -werten.
Eingabetyp/-wert | Beispiel | Rückgabewert |
---|---|---|
undefined | uint(undefined) | 0 |
„null“ | uint(null) | 0 |
0 | uint(0) | 0 |
NaN | uint(NaN) | 0 |
Positive Gleitkommazahl | uint(5.31) | Abgeschnittene vorzeichenlose Ganzzahl (z. B. 5 ) |
Negative Gleitkommazahl | uint(-5.78) | Schneidet die Ganzzahl ab, und wendet dann die Regel für negative Ganzzahlen an |
Negative Ganzzahl | uint(-5) | Die Summe von uint.MAX_VALUE und der negativen Ganzzahl (z. B. uint.MAX_VALUE + (-5) ) |
true | uint(true) | 1 |
false | uint(false) | 0 |
Leerer String | uint("") | 0 |
String, der in einen Number-Wert konvertiert wird | uint("5") | Der number-Wert |
String, der nicht in einen Number-Wert konvertiert wird | uint("5a") | 0 |
Parameter
value:Number — Ein Wert, der in eine Ganzzahl umgewandelt werden soll.
|
uint — Die konvertierte Ganzzahl.
|
Verwandte API-Elemente
unescape | () | Funktion |
public function unescape(str:String):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wertet den Parameter str
als String aus, dekodiert den String aus dem URL-Format (indem er alle Hexadezimalsequenzen in ASCII-Zeichen umwandelt) und gibt den String zurück.
Parameter
str:String — Ein String mit einer Hexadezimalsequenz, die in eine ASCII-Sequenz umgewandelt werden soll.
|
String — Ein String, der mit einem URL-kodierten Parameter dekodiert wurde.
|
Vector | () | Funktion |
public function Vector(sourceArray:Object):Vector.<T>
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Erstellt eine neue Vector-Instanz, deren Elemente Instanzen des festgelegten Datentyps sind. Wenn diese Funktion aufgerufen wird, legen Sie den Datentyp der Elemente des Ergebnisvektors (der Basistyp des Vectors) mithilfe eines type-Parameters fest. Diese Funktion verwendet die gleiche Syntax, die auch beim Deklarieren einer Vector-Instanz oder beim Aufrufen des new Vector.<T>()
-Konstruktors benutzt wird:
var v:Vector.<String> = Vector.<String>(["Hello", "World"]);
Der Ergebnisvektor wird mit den Werten in den Elementen des sourceArray
-Arguments gefüllt. Wenn das sourceArray
-Argument bereits eine Vector.<T>-Instanz ist, in der T
dem Basistyp entspricht, gibt die Funktion diesen Vector zurück. Andernfalls wird der Ergebnisvektor mit den Elementen aus dem sourceArray
-Array oder dem Vector gefüllt.
In beiden Fällen müssen die Datentypen von allen Elementen des sourceArray
-Arguments mit dem im Funktionsaufruf festgelegten Basistyp T
übereinstimmen.
Wenn das sourceArray
-Argument einen length
-Wert von 0 hat, gibt die Funktion einen leeren Vector zurück.
Wenn ein Vector als das sourceArray
-Argument übergeben wird und sein Basistyp nicht T
ist, oder wenn ein Array übergeben wird und nicht alle Elemente Instanzen vom Datentyp T
sind, wird ein Versuch unternommen, die Werte in den Basistyp zu konvertieren. Wenn die Werte automatisch konvertiert werden können, enthält der Ergebnisvektor die konvertierten Werte. Wenn keine Konvertierung vorgenommen werden kann, tritt ein Fehler auf.
Ist ein Element im sourceArray
-Argument eine Instanz einer Unterklasse des Basistyps T
, dann ist der Aufruf erfolgreich und das Element wird dem Ergebnisvektor hinzugefügt. Dies funktioniert auch, wenn das sourceArray
-Argument ein Vector ist, dessen Basistyp eine Unterklasse von T
ist. Dies stellt die einzige Möglichkeit dar, einen Vector mit dem Basistyp T
in einen Vector mit einem Basistyp, der eine Superklasse von T
ist, zu konvertieren.
Der folgende Code führt z. B. zu einem Kompilierungsfehler im Strict-Modus oder einem TypeError zur Laufzeit, da versucht wird, ein Vector.<Sprite> einer Vector.<DisplayObject>-Variablen zuzuweisen (Sprite ist eine Unterklasse von DisplayObject):
var v1:Vector.<Sprite> = new Vector.<Sprite>(); v1[0] = new Sprite(); var v2:Vector.<DisplayObject> = v1;
Die folgende alternative Version des Codes kopiert die Elemente einer Vector.<Sprite>-Instanz erfolgreich in eine Vector.<DisplayObject>-Instanz:
var v1:Vector.<Sprite> = new Vector.<Sprite>(); v1[0] = new Sprite(); var v2:Vector.<DisplayObject> = Vector.<DisplayObject>(v1);
Parameter
sourceArray:Object — Ein Array oder eine Vector-Instanz, dessen oder deren Elemente zu Elementen des Ergebnisvektors werden. Wenn das Argument eine Vector-Instanz ist, deren verknüpfter Datentyp gleich dem festgelegten Datentyp ist, wird das Argument als das Funktionsergebnis zurückgegeben.
|
Vector.<T> — Eine mit den Elementen des sourceArray -Arrays gefüllte Vector-Instanz.
|
Auslöser
TypeError — Wenn das sourceArray -Argument ein Element enthält, das nicht in den festgelegten Datentyp konvertiert werden kann.
|
Verwandte API-Elemente
XML | () | Funktion |
public function XML(expression:Object):XML
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Konvertiert ein Objekt in ein XML-Objekt.
Die folgende Tabelle beschreibt Rückgabewerte für verschiedene Eingabetypen:
Parametertyp | Rückgabewert |
---|---|
Boolescher Ausdruck | Der Wert wird erst in einen String konvertiert und anschließend in ein XML-Objekt. |
Null | Während der Laufzeit tritt ein Fehler auf (TypeError-Ausnahme). |
Number | Der Wert wird erst in einen String konvertiert und anschließend in ein XML-Objekt. |
Object | Wird nur dann in einen XML-Wert konvertiert, wenn es sich um einen String, eine Zahl oder einen booleschen Wert handelt. Andernfalls tritt während der Laufzeit ein Fehler auf (TypeError-Ausnahme). |
String | Wird in einen XML-Wert umgewandelt. |
Nicht festgelegt | Während der Laufzeit tritt ein Fehler auf (TypeError-Ausnahme). |
XML | Der Eingabewert wird unverändert zurückgegeben. |
XMLList | Gibt nur dann ein XML-Objekt aus, wenn das XMLList-Objekt nur eine Eigenschaft vom Typ XML enthält. Andernfalls tritt während der Laufzeit ein Fehler auf (TypeError-Ausnahme). |
Parameter
expression:Object — Ein Objekt, das in einen XML-Wert umgewandelt werden soll.
|
XML — Ein XML-Objekt, das Werte aus dem konvertierten Objekt enthält.
|
Verwandte API-Elemente
XMLList | () | Funktion |
public function XMLList(expression:Object):XMLList
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Konvertiert ein Objekt in ein XMLList-Objekt.
Die folgende Tabelle beschreibt Rückgabewerte für verschiedene Eingabetypen:
Parametertyp | Rückgabewert |
---|---|
Boolescher Ausdruck | Der Wert wird erst in einen String konvertiert und anschließend in ein XMLList-Objekt. |
Null | Während der Laufzeit tritt ein Fehler auf (TypeError-Ausnahme). |
Number | Der Wert wird erst in einen String konvertiert und anschließend in ein XMLList-Objekt. |
Object | Wird nur dann in einen XMLList-Objekt konvertiert, wenn es sich um einen String, eine Zahl oder einen booleschen Wert handelt. Andernfalls tritt während der Laufzeit ein Fehler auf (TypeError-Ausnahme). |
String | Der Wert wird in ein XMLList-Objekt konvertiert. |
Nicht festgelegt | Während der Laufzeit tritt ein Fehler auf (TypeError-Ausnahme). |
XML | Der Wert wird in ein XMLList-Objekt konvertiert. |
XMLList | Der Eingabewert wird unverändert zurückgegeben. |
Parameter
expression:Object — Der Wert wird in ein XMLList-Objekt konvertiert.
|
XMLList — Ein XML-Objekt, das Werte aus dem konvertierten Objekt enthält.
|
Verwandte API-Elemente
Tue Jun 12 2018, 10:19 AM Z