Fonction Boolean

Boolean(expression:Object) : Boolean

Convertit le paramètre expression en valeur booléenne et renvoie une valeur comme indiqué dans la liste suivante :

Si expression est une valeur booléenne, la valeur renvoyée est expression.
Si expression est un nombre, la valeur renvoyée est true si le nombre diffère de zéro ; sinon, la valeur renvoyée est false.

Si expression est une chaîne, renvoie l'une des valeurs suivantes :

Dans les fichiers publiés pour Flash Player 6 ou une version plus récente, la chaîne est tout d'abord convertie en nombre. Sa valeur est true si le nombre est différent de zéro, false dans le cas contraire.
Dans les fichiers publiés pour Flash Player 7 ou version ultérieure, le résultat est true si la longueur de la chaîne est supérieure à zéro et false en cas de chaîne vide.

Si expression est une chaîne, le résultat est true si la longueur de cette chaîne est supérieure à zéro, false en cas de chaîne vide.

Si l'expression est undefined ou NaN (n'est pas un nombre), la valeur renvoyée est false.
Si expression est un clip ou un objet, la valeur renvoyée est true.

Contrairement au constructeur de classe Boolean, la fonction Boolean() n'utilise pas le mot-clé new. De plus, le constructeur de classe Boolean initialise un objet booléen sur false si aucun paramètre n'est spécifié, bien que la fonction Boolean() renvoie undefined en l'absence de paramètres.

Disponibilité : ActionScript 1.0; Flash Lite 2.0 - Comportement modifié dans Flash Player 7.

Paramètres

expression:Object - Une expression à convertir en valeur booléenne.

Valeur renvoyée

Boolean - Valeur booléenne.

Exemple

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


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


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

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

Si les fichiers sont publiés pour Flash Player 6 ou version antérieure, les résultats diffèrent pour trois des exemples précédents :

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

Cet exemple illustre une différence significative entre l'utilisation de la fonction Boolean() et celle de la classe Boolean. La fonction Boolean() permet de créer une valeur booléenne, tandis que la classe Boolean crée un objet booléen. Les valeurs booléennes sont comparées en fonction de leur valeur, tandis que les objets booléens sont comparés par référence.

// Les variables représentant des valeurs booléennes sont comparées en 
// fonction de leur valeur
var a:Boolean = Boolean("a"); // a est True
var b:Boolean = Boolean(1); // b est True
trace(a==b); // True

// Les variables représentant des objets booléens sont comparées par 
// référence
var a:Boolean = new Boolean("a"); // a est True
var b:Boolean = new Boolean(1); // b est True
trace(a == b); // False

Voir aussi

Boolean