Boolean 関数

Boolean(expression:Object) : Boolean

次に示すように、パラメータ expression をブール値に変換して、値を返します。

expression がブール値である場合、戻り値は expression です。
expression が数値あれば、0 でない場合の戻り値は true となり、0 の場合は false となります。

expression がストリングである場合は、戻り値は次のようになります。

Flash Player 6 以前用にパブリッシュされたファイルでは、ストリングはまず数値に変換されます。数値が 0 でない場合の値は true となり、数値が 0 の場合の戻り値は false となります。
Flash Player 7 以降用にファイルをパブリッシュした場合の結果は、ストリングの長さがゼロより長ければ true、空のストリングであれば false になります。

expression がストリングである場合の結果は、ストリングの長さがゼロより長ければ true、空のストリングであれば false になります。

expression が undefined または NaN (非数) であれば、戻り値は false です。
expression がムービークリップまたはオブジェクトであれば、戻り値は true です。

Boolean クラスのコンストラクタとは異なり、Boolean() 関数はキーワード new を使用しません。さらに、Boolean クラスのコンストラクタは、パラメータが指定されない場合に Boolean オブジェクトを false に初期化しますが、Boolean() 関数は、パラメータが指定されない場合に undefined を返します。

対応バージョン : ActionScript 1.0、Flash Player 5 - Flash Player 7 ではビヘイビアが変更されました。

パラメータ

expression:Object - ブール値に変換される式。

戻り値

Boolean - ブール値。

例

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


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


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

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

ファイルを Flash Player 6 以前用にパブリッシュした場合、上記の 3 つの例は次のように異なる結果となります。

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

この例では、Boolean() 関数と Boolean クラスの使い方の大きな違いを示します。Boolean() 関数はブール値を作成し、Boolean クラスは Boolean オブジェクトを作成します。ブール値は値で比較され、Boolean オブジェクトは参照で比較されます。

// Variables representing Boolean values are compared by value
var a:Boolean = Boolean("a"); // a is true
var b:Boolean = Boolean(1); // b is true
trace(a==b); // true

// Variables representing Boolean objects are compared by reference
var a:Boolean = new Boolean("a"); // a is true
var b:Boolean = new Boolean(1); // b is true
trace(a == b); // false

Boolean 関数

パラメータ

戻り値

例

関連項目