Ein spezieller Wert, der eine positive Infinity repräsentiert. Der Wert dieser Konstante entspricht Number.POSITIVE_INFINITY.

Siehe auch

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

Ein spezieller Wert, der eine negative Infinity repräsentiert. Der Wert dieser Konstante entspricht Number.NEGATIVE_INFINITY.

Siehe auch

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

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

Siehe auch

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.

Siehe auch

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

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

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

Erstellt ein neues Array. Das Array kann eine Länge von 0 oder mehr haben und anhand einer Liste mit angegebenen Elementen, möglicherweise unterschiedlichen Datentyps, ausgefüllt werden. Anhand der Anzahl und dem Datentyp der Argumente können Sie den Inhalt des zurückgegeben Arrays bestimmen.

• 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.
• Wenn Sie Array() mit einer Liste an gegebenen Werten aufrufen, wird ein Array mit Elementen zurückgegeben, das jeden der angegebenen Werte enthält.

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

Parameter

Siehe auch

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

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

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

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

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:

Im Gegensatz zu früheren ActionScript-Versionen gibt die Funktion Boolean() dasselbe Ergebnis zurück wie der Klassenkonstruktor Boolean.

Parameter

Siehe auch

Gibt eine Stringdarstellung des aktuellen Wochentags, des Datums, der Uhrzeit und der Zeitzone zurück. Das Datum für die Ausgabe hat das folgende Format:

     Day Mon Date HH:MM:SS TZD YYYY
     

Dabei gilt u. a.:

     Wed Apr 12 15:30:17 GMT-0700 2006
     

Um einen Wert als Datentyp Date auszugeben, verwenden Sie x as Date anstelle von Date(x).

Siehe auch

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

Parameter

Siehe auch

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

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 so genannten URI-Komponente, konzipiert ist. Eine URI-Komponente ist ein beliebiger Text, der zwischen speziellen Zeichen, den so genannten 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 decodiert werden soll.

Parameter

Siehe auch

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.

Parameter

Siehe auch

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

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 so genannten URI-Komponente, konzipiert ist. Eine URI-Komponente ist ein beliebiger Text, der zwischen speziellen Zeichen, den so genannten 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 codiert werden soll.

Die folgende Tabelle zeigt alle Zeichen, die nicht von der Funktion encodeURIComponent in UTF-8-Escape-Sequenzen konvertiert werden.

Parameter

Siehe auch

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

Parameter

Siehe auch

Konvertiert einen bestimmten numerischen Wert in eine Ganzzahl. Dezimalwerte werden an der Dezimalstelle abgeschnitten.

Parameter

Siehe auch

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

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

Parameter

Bestimmt, ob der angegebene String ein gültiger Name für ein XML-Element oder -Attribut ist.

Parameter

Konvertiert einen bestimmten Wert in einen Number-Wert. Die folgende Tabelle zeigt das Ergebnis verschiedener Eingabetypen:

Parameter

Siehe auch

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

Siehe auch

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

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

Gibt den angegebenen Parameter als String zurück.

Die folgende Tabelle zeigt das Ergebnis verschiedener Eingabetypen:

Parameter

Siehe auch

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

package {
    import flash.display.Sprite;

    public class TraceExample extends Sprite {

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

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.

Parameter

Siehe auch

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

Konvertiert ein Objekt in ein XML-Objekt.

Die folgende Tabelle beschreibt Rückgabewerte für verschiedene Eingabetypen:

Parameter

Siehe auch

Konvertiert ein Objekt in ein XMLList-Objekt.

Die folgende Tabelle beschreibt Rückgabewerte für verschiedene Eingabetypen:

Parameter

Siehe auch