ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
 

Oberste Ebene 


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.
Globale Funktionen
 FunktionDefiniert von
  
Erstellt ein neues Array.
Oberste Ebene
  
Boolean(expression:Object):Boolean
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
  
int(value:Number):int
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
  
Number(expression:Object):Number
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
  
parseInt(str:String, radix:uint = 0):Number
Wandelt einen String in eine Ganzzahl um.
Oberste Ebene
  
String(expression:Object):String
Gibt den angegebenen Parameter als String zurück.
Oberste Ebene
  
trace(... arguments):void
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
  
Vector(sourceArray:Object):Vector.<T>
Erstellt eine neue Vector-Instanz, deren Elemente Instanzen des festgelegten Datentyps sind.
Oberste Ebene
  
XML(expression:Object):XML
Konvertiert ein Objekt in ein XML-Objekt.
Oberste Ebene
  
XMLList(expression:Object):XMLList
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.
Globale Konstanten
 KonstanteDefiniert 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
Konstantendetails

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

Eine Division durch 0 resultiert nur dann in dem Wert -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 )

Eine Division durch 0 resultiert nur dann in dem Wert 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 Infinity. Ist der Divisor kleiner 0, resultiert die Division durch 0 in dem Wert -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 von Infinity;
  • Infinity oder -Infinity geteilt durch Infinity 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 ist NaN.
  • Der von int(undefined) und uint(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 )

Im folgenden Beispiel wurde eine nicht typisiert Variable (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

Die gleiche Regel trifft auch auf nicht initialisierte Eigenschaften von dynamischen Objekten zu. So lautet beispielsweise bei einer Instanz 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

Funktionsdetails

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.
Die Verwendung der 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.

Rückgabewerte
Array — Ein Array mit einer Länge von mindestens 0.

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

Das folgende Beispiel veranschaulicht das Verhalten der Funktion 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

Um 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:

EingabewertBeispielRückgabewert
0Boolean(0)false
NaNBoolean(NaN)false
Number (nicht 0 oder NaN)Boolean(4)true
Leerer StringBoolean("")false
Nicht leerer StringBoolean("6")true
„null“Boolean(null)false
undefinedBoolean(undefined)false
Instanz der Object-KlasseBoolean(new Object())true
Kein ArgumentBoolean()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.

Rückgabewerte
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-SequenzenZeichenentsprechungen
%23#
%24$
%26&
%2B+
%2C,
%2F/
%3A:
%3B;
%3D=
%3F?
%40@

Parameter

uri:String — Ein mit der Funktion encodeURI kodierter String.

Rückgabewerte
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.

Rückgabewerte
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.

Rückgabewerte
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

Rückgabewerte
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.

Rückgabewerte
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.

Rückgabewerte
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.

Rückgabewerte
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/-wertBeispielRückgabewert
0 durch 0 dividiertisNaN(0/0)true
Eine Zahl ungleich Null durch 0 dividiertisNaN(5/0)false
Quadratwurzel aus einer negativen ZahlisNaN(Math.sqrt(-1))true
Arkussinus einer Zahl, die größer als 1 oder kleiner als 0 istisNaN(Math.asin(2))true
String, der in einen Number-Wert konvertiert werden kannisNaN("5")false
String, der nicht in einen Number-Wert konvertiert werden kannisNaN("5a")true

Parameter

num:Number — Ein zu berechnender numerischer oder mathematischer Ausdruck.

Rückgabewerte
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.

Rückgabewerte
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/-wertBeispielRückgabewert
undefinedNumber(undefined)NaN
„null“Number(null)0
trueNumber(true)1
falseNumber(false)0
NaNNumber(NaN)NaN
Leerer StringNumber("")0
String, der in einen Number-Wert konvertiert wirdNumber("5")Die Zahl (z. B. 5)
String, der nicht in einen Number-Wert konvertiert wirdNumber("5a")NaN

Parameter

expression:Object — Ein Wert, der in einen Number-Wert umgewandelt werden soll.

Rückgabewerte
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.

Rückgabewerte
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.

Rückgabewerte
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.

Rückgabewerte
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/-wertRückgabewert
undefinedundefined
„null“"null"
true"true"
false"false"
NaN"NaN"
StringString
ObjectObject.toString()
NumberDie Stringdarstellung der Zahl

Parameter

expression:Object — Ein Ausdruck, der in einen String umgewandelt werden soll.

Rückgabewerte
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 )

Im folgenden Beispiel wird mithilfe der 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/-wertBeispielRückgabewert
undefineduint(undefined)0
„null“uint(null)0
0uint(0)0
NaNuint(NaN)0
Positive Gleitkommazahluint(5.31)Abgeschnittene vorzeichenlose Ganzzahl (z. B. 5)
Negative Gleitkommazahluint(-5.78)Schneidet die Ganzzahl ab, und wendet dann die Regel für negative Ganzzahlen an
Negative Ganzzahluint(-5)Die Summe von uint.MAX_VALUE und der negativen Ganzzahl (z. B. uint.MAX_VALUE + (-5))
trueuint(true)1
falseuint(false)0
Leerer Stringuint("")0
String, der in einen Number-Wert konvertiert wirduint("5")Der number-Wert
String, der nicht in einen Number-Wert konvertiert wirduint("5a")0

Parameter

value:Number — Ein Wert, der in eine Ganzzahl umgewandelt werden soll.

Rückgabewerte
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.

Rückgabewerte
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.

Rückgabewerte
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:

ParametertypRückgabewert
Boolescher AusdruckDer Wert wird erst in einen String konvertiert und anschließend in ein XML-Objekt.
NullWährend der Laufzeit tritt ein Fehler auf (TypeError-Ausnahme).
NumberDer Wert wird erst in einen String konvertiert und anschließend in ein XML-Objekt.
ObjectWird 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).
StringWird in einen XML-Wert umgewandelt.
Nicht festgelegtWährend der Laufzeit tritt ein Fehler auf (TypeError-Ausnahme).
XMLDer Eingabewert wird unverändert zurückgegeben.
XMLListGibt 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.

Rückgabewerte
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:

ParametertypRückgabewert
Boolescher AusdruckDer Wert wird erst in einen String konvertiert und anschließend in ein XMLList-Objekt.
NullWährend der Laufzeit tritt ein Fehler auf (TypeError-Ausnahme).
NumberDer Wert wird erst in einen String konvertiert und anschließend in ein XMLList-Objekt.
ObjectWird 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).
StringDer Wert wird in ein XMLList-Objekt konvertiert.
Nicht festgelegtWährend der Laufzeit tritt ein Fehler auf (TypeError-Ausnahme).
XMLDer Wert wird in ein XMLList-Objekt konvertiert.
XMLListDer Eingabewert wird unverändert zurückgegeben.

Parameter

expression:Object — Der Wert wird in ein XMLList-Objekt konvertiert.

Rückgabewerte
XMLList — Ein XML-Objekt, das Werte aus dem konvertierten Objekt enthält.

Verwandte API-Elemente

[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.