Boolean 関数

Boolean(expression: Object) : Boolean

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

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

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

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

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

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

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

使用できるバージョン : ActionScript 1.0、Flash Lite 2.0 - 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 オブジェクトは参照で比較されます。

// ブール値を示す変数を値で比較する
var a: Boolean = Boolean("a"); // a は true
var b: Boolean = Boolean(1); // b は true
trace(a==b); // true

// Boolean オブジェクトを示す変数を参照で比較する
var a: Boolean = new Boolean("a"); // a は true
var b: Boolean = new Boolean(1); // b は true
trace(a == b); // false

Boolean 関数

パラメータ

戻り値

例

関連項目