新しい配列を作成します。長さがゼロ以上の配列、または指定したエレメントのリスト (異なるデータ型を含めることができます) を使用して設定された配列を作成できます。使用する引数の数およびデータ型によって、返される配列の内容が決定します。

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

引数がプリミティブな値ではない場合は、明示的な型変換する as 演算子、または型のキャストを使用します。詳細については、この項の「例」のセクションを参照してください。

関連項目

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

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

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

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

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

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

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

関連項目

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

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

関連項目

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 コンポーネントを処理することを想定しているため、特殊なセパレータ文字 (; / ? : @ & = + $ , #) を表すエスケープシーケンスが、デコードの必要がある通常のテキストとして扱われることです。

関連項目

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

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

関連項目

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 コンポーネントを処理することを想定しているため、特殊なセパレータ文字 (; / ? : @ & = + $ , #) が、エンコードの必要がある通常のテキストとして扱われることです。

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

関連項目

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

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

関連項目

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

関連項目

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

値が NaN (非数) の場合は、true を返します。isNaN() 関数は、数式が正常に数値に評価されるかどうかをチェックするのに便利です。NaN 値は、"非数" の値を表す Number データ型の特殊メンバーです。

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

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

指定されたストリングが、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() の戻り値を示します。

関連項目

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

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

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

関連項目

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

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

関連項目

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

関連項目

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

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

関連項目

trace(0 / 0);  // Output: NaN
trace(7 / 0);  // Output: Infinity
trace(-7 / 0); // Output: -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() を使用します。

関連項目

初期化されていない型指定のない変数、または初期化されていないダイナミックオブジェクトプロパティに適用される特殊な値です。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 になります。

関連項目

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

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

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