valueOf (Object.valueOf-Methode)

public valueOf() : Object

Gibt den Grundwert des angegebenen Objekts zurück. Wenn das Objekt keinen Grundwert aufweist, wird das Objekt selbst zurückgegeben.

Verfügbarkeit: ActionScript 1.0, Flash Lite 2.0

Rückgabewerte

Object - Der Grundwert des angegebenen Objekts oder das Objekt selbst.

Beispiel

Das folgende Beispiel zeigt den Rückgabewert von valueOf() für ein generisches Objekt (ohne Grundwert) und vergleicht es mit dem Rückgabewert von toString(). Erstellen Sie zunächst ein generisches Objekt. Erstellen Sie anschließend ein neues Date-Objekt mit dem Wert 1. Februar 2004, 8.15 Uhr. Die Methode toString() gibt die aktuelle Zeit in lesbarer Form zurück. Die Methode valueOf() gibt den Grundwert in Millisekunden zurück. Erstellen Sie drittens ein neues Array-Objekt mit zwei einfachen Elementen. toString() und valueOf() geben den gleichen Wert zurück: one,two:

// generisches Objekt erstellen
var myObject:Object = new Object();
trace(myObject.valueOf()); // Ausgabe: [object Object]
trace(myObject.toString()); // Ausgabe: [object Object]

In den folgenden Beispielen werden die Rückgabewerte für die integrierten Klassen Date und Array dargestellt und mit den Rückgabewerten von Object.toString() verglichen:

// neues Date-Objekt für das Datum 1. Februar 2004, 8.15 Uhr erstellen
// Die toString()-Methode gibt die aktuelle Zeit in lesbarem Format zurück.
// Die valueOf()-Methode gibt den Grundwert in Millisekunden zurück.
var myDate:Date = new Date(2004,01,01,8,15);
trace(myDate.toString()); // Ausgabe: Sun Feb 1 08:15:00 GMT-0800 2004
trace(myDate.valueOf()); // Ausgabe: 1075652100000

// neues Array-Objekt mit zwei einfachen Elementen erstellen
// toString() und valueOf() geben in diesem Fall den gleichen Wert zurück: one,two
var myArray:Array = new Array("one", "two");
trace(myArray.toString()); // Ausgabe: one,two
trace(myArray.valueOf()); // Ausgabe: one,two

Das Beispiel für Object.toString() ist gleichzeitig ein Beispiel für den Rückgabewert von Object.valueOf() bei einer benutzerdefinierten Klasse, die Vorrang vor toString() hat.

Siehe auch

toString (Object.toString-Methode)