Boolean-Funktion

Boolean(expression:Object) : Boolean

Wandelt den Parameter expression in einen booleschen Wert um und gibt entsprechend der folgenden Liste einen Wert zurück:

Wenn expression ein boolescher Wert ist, lautet der Rückgabewert expression.
Ist expression eine Zahl, lautet der Rückgabewert true, wenn die Zahl ungleich 0 ist. Andernfalls lautet der Rückgabewert false.

Wenn expression ein String ist, lautet der Rückgabewert wie folgt:

In Dateien, die für Flash Player 6 oder früher veröffentlicht wurden, wird der String zuerst in eine Zahl umgewandelt. Der Wert lautet true, wenn die Zahl ungleich 0 ist, andernfalls false.
In Dateien, die für Flash Player 7 und spätere Versionen veröffentlicht wurden, ist das Ergebnis true, wenn der String eine Länge größer als 0 aufweist. Bei einem leeren String ist der Wert false.

Ist expression ein String, lautet das Ergebnis true, wenn der String länger ist als 0. Ein leerer String dagegen ergibt den Wert false.

Wenn expression den Wert undefined oder NaN (Not a Number - keine Zahl) hat, lautet der Rückgabewert false.
Wenn expression ein Movieclip oder ein Objekt ist, lautet der Rückgabewert true.

Im Gegensatz zum Klassenkonstruktor Boolean verwendet die Funktion Boolean() nicht das Schlüsselwort new. Darüber hinaus initialisiert der Klassenkonstruktor Boolean ein boolesches Objekt mit dem Wert false, wenn kein Parameter angegeben wird, während die Funktion Boolean() in diesem Fall den Wert undefined zurückgibt.

Verfügbarkeit: ActionScript 1.0, Flash Lite 2.0. Verhalten wurde ab Flash Player 7 geändert.

Parameter

expression:Object - Ein Ausdruck, der in einen booleschen Wert umgewandelt werden soll.

Rückgabewerte

Boolean - Ein boolescher Wert.

Beispiel

trace(Boolean(-1)); // Ausgabe: true
trace(Boolean(0)); // Ausgabe: false
trace(Boolean(1)); // Ausgabe: true


trace(Boolean(true)); // Ausgabe: true
trace(Boolean(false)); // Ausgabe: false


trace(Boolean("true")); // Ausgabe: true
trace(Boolean("false")); // Ausgabe: true

trace(Boolean("Craiggers")); // Ausgabe: true
trace(Boolean("")); // Ausgabe: false

Wenn die Dateien für Flash Player bis Version 6 veröffentlicht werden, ergeben sich für drei der oben stehenden Beispiele andere Werte:

trace(Boolean("true")); // Ausgabe: false
trace(Boolean("false")); // Ausgabe: false
trace(Boolean("Craiggers")); // Ausgabe: false

Dieses Beispiel veranschaulicht den beträchtlichen Unterschied zwischen der Verwendung der Funktion Boolean() und der Klasse Boolean. Die Funktion Boolean() erstellt einen booleschen Wert, die Klasse Boolean dagegen ein boolesches Objekt. Boolesche Werte werden dem Wert nach verglichen, boolesche Objekte anhand ihrer Referenz.

// Variablen, die boolesche Werte darstellen, werden anhand ihres 
// Werts verglichen
var a:Boolean = Boolean("a"); // a ist true
var b:Boolean = Boolean(1); // b ist true
trace(a==b); // true

// Variablen, die boolesche Objekte darstellen, werden anhand ihrer Referenz verglichen
var a:Boolean = new Boolean("a"); // a ist true
var b:Boolean = new Boolean(1); // b ist true
trace(a == b); // false

Siehe auch

Boolean