トップレベル 

負の Infinity を表す特殊な値です。この定数の値は、Number.NEGATIVE_INFINITY と同じです。

関連する API エレメント

trace(0 / 0);  // NaN
trace(7 / 0);  // Infinity
trace(-7 / 0); // -Infinity

正の Infinity を表す特殊な値です。この定数の値は、Number.POSITIVE_INFINITY と同じです。

関連する API エレメント

trace(0 / 0);  // NaN
trace(7 / 0);  // Infinity
trace(-7 / 0); // -Infinity

"非数"（NaN）の値を表す Number データ型の特殊メンバーです。数式の結果が数値として表現できない値になる場合、その結果は NaN になります。次のリストでは、結果が NaN になる一般的な式について説明します。

• 除数も 0 の場合にのみ、0 による除算の結果が NaN になります。 除数が 0 よりも大きい場合は、0 による除算の結果は Infinity になります。 除数が 0 よりも小さい場合は、0 による除算の結果は -Infinity になります。
• 負の数の平方根です。
• 有効な範囲（0 ～ 1）外の数値のアークサインです。
• Infinity から減算された Infinity です。
• Infinity または -Infinity（Infinity または -Infinity で除算）です。
• 0 で乗算された Infinity または -Infinity です。

NaN 値は、int または uint データ型のメンバーではありません。

NaN 値は、NaN を含む他のどの値とも等しいと見なされないため、等価演算子を使用して、式が NaN であるかどうかをテストできません。数値が NaN 関数かどうかを判別するには、isNaN() を使用します。

関連する API エレメント

初期化されていない型指定のない変数、または初期化されていないダイナミックオブジェクトプロパティに適用される特殊な値です。ActionScript 3.0 では、型指定のない変数のみが値 undefined を保持できます。ただしこれは、ActionScript 1.0 および ActionScript 2.0 には当てはまりません。例えば、次の変数は型指定も初期化も行われていないため、いずれも undefined になります。

• var foo;
• var bar:*;

また、undefined 値は初期化されていない、または定義されていないダイナミックオブジェクトのプロパティにも適用されます。例えば、オブジェクトが Object クラスのインスタンスの場合、動的に割り当てられたプロパティに値が割り当てられるまで、そのプロパティの値は undefined です。

さまざまな関数で undefined が使用されている場合は、結果が異なります。

• String(undefined) によって返される値は "undefined" です（undefined はストリングに変換されます）。
• Number(undefined) によって返される値は NaN です。
• int(undefined) および uint(undefined) によって返される値は 0 です。
• Object(undefined) によって返される値は、新しい Object インスタンスです。
• 値 undefined を型指定されている変数に割り当てると、その値はそのデータ型のデフォルト値に変換されます。

undefined を null と混同しないようにしてください。null と undefined を等価演算子（==）で比較すると、結果は true になります。ただし、null と undefined を厳密な等価演算子（===）で比較すると、結果は false になります。

関連する API エレメント

// trace value of untyped and uninitialized variable
var myVar;
trace(myVar); // undefined

dynamic class A {}
var obj:A = new A()

// trace undefined property of obj
trace(obj.propName); // undefined

新しい配列を作成します。配列は 0 以上の長さにするか、1 つの指定したオブジェクトで設定された配列にすることができます。

• 引数なしで Array() を呼び出すと、空の配列が返されます。
• 単一の整数の引数を指定して Array() を呼び出すと、指定された長さの配列が返されますが、その各エレメントの値は未定義です。
• オブジェクトを指定して Array() を呼び出すことで、指定したオブジェクトの 1 つのエレメントを含む配列が返されます。

注意：Array() 関数を使用して新しい配列を作成し、複数の値をパラメーターとして渡して配列を設定しようとすると、コンパイラーエラーが発生します。Array() 関数では 1 つのパラメーターのみを指定できます。複数の値を持つ配列を作成および設定するには、代わりに Array クラスコンストラクターを使用します。

Array() 関数はオブジェクトの型を配列にキャストしません。引数がプリミティブな値ではない場合は、明示的な型の変換や型のキャストには as 演算子を使用します。詳細については、この項の「例」のセクションを参照してください。Array() 関数にパラメーターとしてオブジェクトを渡すと、オブジェクトをエレメントとして含む新しい配列が作成されます。

パラメーター

関連する API エレメント

var obj:Object = [ "a", "b", "c" ];
      
var newArray:Array = Array( obj );

trace(newArray == obj);    // false
trace(newArray[0] == obj); // true
trace(newArray[0][0])      // a
trace(newArray[0][1])      // b
trace(newArray[0][2])      // c

var obj:Object = [ "a", "b", "c" ];
      
var newArray:Array = obj as Array;

trace(newArray == obj); // true
trace(newArray[0]);     // a
trace(newArray[1]);     // b
trace(newArray[2]);     // c

expression パラメーターをブール値に変換し、その値を返します。

戻り値は、次の表に示すように、引数のデータ型および値によって異なります。

ActionScript の以前のバージョンとは異なり、Boolean() 関数は Boolean クラスのコンストラクターと同じ結果を返します。

パラメーター

エンコードされた URI をストリングにデコードします。encodeURI 関数でエンコードされていたすべての文字が、エンコードされていない表現に復元されたストリングを返します。

次の表に、文字にデコードされない（decodeURI 関数において）エスケープシーケンスのセットを示します。この表にあるエスケープシーケンスをデコードするには、decodeURIComponent() を使用してください。

パラメーター

関連する API エレメント

package {
    import flash.display.Sprite;

    public class DecodeURIExample extends Sprite {
        public function DecodeURIExample() {
            var uri:String = "http://www.example.com/application.jsp?user=<user name='some user'></user>";
            var encoded:String = encodeURI(uri);
            var decoded:String = decodeURI(encoded);
            trace(uri);        // http://www.example.com/application.jsp?user=<user name='some user'></user>
            trace(encoded);    // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E
            trace(decoded);    // http://www.example.com/application.jsp?user=<user name='some user'></user>
        }
    }
}

エンコードされた URI コンポーネントをストリングにデコードします。encodeURIComponent 関数でエスケープされていたすべての文字が、エンコードされていない表現に復元されたストリングを返します。

この関数は、URI ストリングの一部（URI コンポーネントと呼びます）のみの変換を目的とします。この点で、decodeURI() 関数とは異なります。URI コンポーネントは、コンポーネントセパレーターと呼ばれる特殊文字（: / ; ?）の間に表示される任意のテキストです。 URI コンポーネントの一般的な例は、"http" および "www.adobe.com" です。

この関数と decodeURI() のもう 1 つの重要な相違点は、この関数は URI コンポーネントを処理することを想定しているので、特殊なセパレーター文字（; / ? : @ & = + $ , #）を表すエスケープシーケンスが、デコードの必要がある通常のテキストとして扱われることです。

パラメーター

関連する API エレメント

ストリングを有効な URI（Uniform Resource Identifier）にエンコードします。完全 URI をストリングに変換します。基本文字の小さなグループに属していない限り、すべての文字が UTF-8 エスケープシーケンスとしてエンコードされます。

次の表に、UTF-8 エスケープシーケンスに変換されない（encodeURI 関数で変換されない）すべての文字を示します。

パラメーター

関連する API エレメント

package {
    import flash.display.Sprite;

    public class EncodeURIExample extends Sprite {
        public function EncodeURIExample() {
            var uri:String = "http://www.example.com/application.jsp?user=<user name='some user'></user>";
            var encoded:String = encodeURI(uri);
            var decoded:String = decodeURI(encoded);
            trace(uri);        // http://www.example.com/application.jsp?user=<user name='some user'></user>
            trace(encoded);    // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E
            trace(decoded);    // http://www.example.com/application.jsp?user=<user name='some user'></user>
        }
    }
}

ストリングを有効な URI コンポーネントにエンコードします。URI のサブストリングをストリングに変換します。基本文字の非常に小さなグループに属していない限り、すべての文字が UTF-8 エスケープシーケンスとしてエンコードされます。

encodeURIComponent() 関数は、URI ストリングの一部（URI コンポーネントと呼びます）のみの変換を目的とします。この点で、encodeURI() 関数とは異なります。URI コンポーネントは、コンポーネントセパレーターと呼ばれる特殊文字（: / ; ?）の間に表示される任意のテキストです。 URI コンポーネントの一般的な例は、"http" および "www.adobe.com" です。

この関数と encodeURI() のもう 1 つの重要な相違点は、この関数は URI コンポーネントを処理することを想定しているので、特殊なセパレーター文字（; / ? : @ & = + $ , #）が、エンコードの必要がある通常のテキストとして扱われることです。

次の表に、UTF-8 エスケープシーケンスに変換されない（encodeURIComponent 関数で変換されない）すべての文字を示します。

パラメーター

関連する API エレメント

パラメーターをストリングに変換し、URL エンコード形式にエンコードします。この場合、英数字以外のほとんどの文字は % が付いた 16 進シーケンスで置き換えられます。URL エンコードされたストリング内のパーセント記号（%）は、エスケープ文字の開始を表すもので、剰余演算子（%）ではありません。

次の表に、エスケープシーケンスに変換されない（escape() 関数で変換されない）すべての文字を示します。

注意：特殊なセパレーター文字（@ + /）を通常のテキストとしてエンコードするには、escape() 関数ではなく encodeURIComponent() 関数を使用します。

パラメーター

関連する API エレメント

指定した数値を整数値に変換します。10 進数値は小数点で切り捨てられます。

パラメーター

関連する API エレメント

値が有限の場合は true を返します。false を返すのは、値が Infinity または -Infinity である場合です。Infinity または -Infinity は、0 による除算などの数学的なエラーの可能性を示します。

パラメーター

true を返します（値が NaN（非数）の場合）。isNaN() 関数は、数式が正常に数値に評価されるかどうかをチェックするのに便利です。isNaN() は、parseInt() 関数および parseFloat() 関数から返された値をチェックするために最もよく使用されます。NaN 値は、"非数" の値を表す Number データ型の特殊メンバーです。

注意：NaN 値は、int または uint データ型のメンバーではありません。

次の表に、さまざまな入力タイプや値での isNaN() の戻り値を示します。 コンパイラー警告が Strict モードに設定されている場合、次の演算の一部がコンパイラー警告を生成する場合があります。

パラメーター

指定されたストリングが、XML エレメントまたは属性に対して有効な名前かどうかを判断します。

パラメーター

指定した数値を Number 値に変換します。次の表に、さまざまな入力タイプの結果を示します。

パラメーター

ActionScript 3.0 ではすべての値がオブジェクトであるため、値に対して Object() を呼び出すと、その値が返されます。

パラメーター

ストリングを浮動小数に変換します。この関数は、初期数の一部でない文字に達するまで、ストリング内の数値を読み取り（解析し）、結果を返します。ストリングが解析できる数値で始まっていない場合、parseFloat() は NaN を返します。有効な整数の前の空白は、後続の非数値文字と同様に無視されます。

パラメーター

ストリングを整数に変換します。パラメーターで指定されたストリングを数値に変換できない場合は NaN を返します。0x から始まる整数は、16 進数と解釈されます。ActionScript の以前のバージョンと異なり、0 から始まる整数は 8 進数と解釈されません。8 進数には 8 の基数を指定する必要があります。有効な整数の前の空白およびゼロは、後続の非数値文字と同様に無視されます。

パラメーター

指定されたパラメーターのストリング表現を返します。

次の表に、さまざまな入力タイプの結果を示します。

パラメーター

デバッグ中に式を表示、またはログファイルに書き込みます。単一のトレースステートメントに複数の引数を指定できます。trace ステートメント内の引数に String 以外のデータ型が含まれている場合は、trace 関数によって、そのデータ型に関連付けられた toString() メソッドが呼び出されます。例えば、引数がブール値の場合、trace 関数で Boolean.toString() が呼び出され、戻り値が表示されます。

パラメーター

package {
    import flash.display.Sprite;

    public class TraceExample extends Sprite {

        public function TraceExample() {
            trace("Hello World");
        }
    }
}

指定した数値を符号なし整数値に変換します。10 進数値は小数点で切り捨てられます。

次の表に、さまざまな入力タイプや値での uint() の戻り値を示します。

パラメーター

関連する API エレメント

パラメーター str をストリングとして評価し、URL エンコードされた形式からストリングをデコード（すべての 16 進シーケンスを ASCII 文字に変換）して、ストリングを返します。

パラメーター

エレメントが指定されたデータ型のインスタンスである新しい Vector インスタンスを作成します。この関数を呼び出す場合、type パラメーターを使用して結果ベクターのエレメント（ベクターのベース型）のデータ型を指定します。この関数は、Vector インスタンスを宣言する場合、または新しい Vector.<T>() コンストラクターを呼び出す場合に使用するシンタックスと同じシンタックスを使用します。

var v:Vector.<String> = Vector.<String>(["Hello", "World"]);

生成されるベクターには sourceArray 引数のエレメントの値が設定されます。sourceArray 引数が Vector.<T> インスタンス（ここで、T はベース型です）の場合、関数はそのベクターを返します。それ以外の場合、結果ベクターには sourceArray 配列（ベクター）のエレメントが設定されます。

どちらの場合も、sourceArray 引数のすべてのエレメントのデータ型が、関数呼出しで指定されたベース型 T と一致する必要があります。

sourceArray 引数が length 0 を持つ場合、関数は空のベクターを返します。

ベクターが sourceArray 引数として渡され、そのベース型が T ではない場合、または配列が渡され、そのエレメントがデータ型 T のすべてのインスタンスではない場合、ベース型の値の変換が試行されます。値が自動的に変換される場合、結果ベクターは変換された値を取り込みます。変換が行われない場合、エラーが発生します。

同様に、sourceArray 引数のエレメントがベース型 T のサブクラスのインスタンスの場合、呼出しは成功し、エレメントが生成されるベクターに追加されます。sourceArray 引数がベース型 T のサブクラスのベクターである場合でも、この機能は有効です。実際に、この機能は、ベース型 T を持つベクターを T のスーパークラスであるベース型を持つベクターに変換する唯一の方法です。

例えば、次のコードは、Strict モードの場合にコンパイルエラーを引き起こすか、実行時に TypeError を引き起こします。これは、Vector.<Sprite> を Vector.<DisplayObject> 変数に割り当てようとするためです（Sprite は DisplayObject のサブクラスです）。

     var v1:Vector.<Sprite> = new Vector.<Sprite>();
     v1[0] = new Sprite();
     var v2:Vector.<DisplayObject> = v1;
     

次の代替バージョンのコードは、Vector.<Sprite> インスタンスを Vector.<DisplayObject> インスタンスに正常にコピーします。

     var v1:Vector.<Sprite> = new Vector.<Sprite>();
     v1[0] = new Sprite();
     var v2:Vector.<DisplayObject> = Vector.<DisplayObject>(v1);
     

パラメーター

関連する API エレメント

オブジェクトを XML オブジェクトに変換します。

次の表に、さまざまな入力タイプでの戻り値を示します。

パラメーター

関連する API エレメント

オブジェクトを XMLList オブジェクトに変換します。

次の表に、さまざまな入力タイプでの戻り値を示します。

パラメーター

関連する API エレメント