最上層 

代表負 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

Number 資料類型的特殊成員，代表「不是數字」(NaN) 的值。當數學運算式產生不能以數字表示的值，結果就是 NaN。下列清單說明產生 NaN 的常見運算式。

• 除以 0 的結果是 NaN，但是只限除數也是 0 時。如果除數大於 0，除以 0 則會產生 Infinity。如果除數小於 0，除以 0 則會產生 -Infinity。
• 負值的平方根；
• 數字的反正弦函數值在 0 到 1 的有效範圍外；
• 從 Infinity 減掉 Infinity；
• Infinity 或 -Infinity 除以 Infinity 或 -Infinity；
• Infinity 或 -Infinity 乘以 0。

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，其結果會是相等的。然而，如果用嚴謹相等運算子 (===) 來比較 (null 和 undefined)，其結果不會相等。

相關 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

建立新的陣列。陣列長度可以為零或更長，或是以單一指定物件填入的陣列。

• 呼叫 Array() 而不使用任何引數，便會傳回空的陣列。
• 使用單一整數引數呼叫 Array()，便會傳回具有指定之長度的陣列，不過其元素會有未定義的值。
• 以指定物件呼叫 Array() 會傳回包含指定物件元素的陣列。

注意：如果嘗試使用 Array() 函數建立新陣列，並傳送數個值作為參數以填入陣列，將會出現編譯器錯誤。Array() 函數僅允許一個參數。請改用 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 參數轉換成 Boolean 值，並傳回該值。

傳回的值取決於引數的資料類型與值，如下表所述：

不同於舊版的 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 函數逸出的字元，都會還原成其未編碼的形式。

此函數不同於 decodeURI() 函數，只會在 URI 字串的部分使用，這種部分稱為 URI 組件。URI 組件是在稱為「組件分隔符號」(: / ; 和 ?)。URI 組件的常見範例是 "http" 與 "www.adobe.com"。

此函數與 decodeURI() 之間的另一項重要差別在於，因為此函數認為本身在處理 URI 組件，因此會將代表特殊分隔符號字元 (; / ? : @ & = + $ , #) 的跳脫序列，視為應該解碼的一般文字。

參數

相關 API 元素

將字串編碼成有效的 URI (統一資源識別項)。完整的 URI 轉換成字串，其中所有的字元都編碼成 UTF-8 逸出序列 (除非有字元屬於小的基本字元群組)。

下表顯示「不會」由 encodeURI 函數轉換成 UTF-8 逸出序列的完整基本字元集。

參數

相關 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() 函數不同於 encodeURI() 函數，只會在 URI 字串的部分 (這種部分稱為 URI 組件) 使用。URI 組件是在稱為「組件分隔符號」(: / ; 和 ?)。URI 組件的常見範例是 "http" 與 "www.adobe.com"。

此函數與 encodeURI() 之間的另一項重要差別在於，因為此函數假設本身在處理 URI 組件，因此會將代表特殊分隔符號字元 (; / ? : @ & = + $ , #) 的跳脫序列，視為應該編碼的一般文字。

下表顯示「不會」 由 encodeURIComponent 函數轉換成 UTF-8 逸出序列的完整基本字元集。

參數

相關 API 元素

將參數轉換成字串，並以 URL 編碼格式將其編碼，其中所有非英數字元都會以 % 十六進位序列取代。在 URL 編碼字串中使用時，百分比符號 (%) 是用來引入反斜線字元的，不等同於模除運算子 (% )。

下表顯示「不會」 由 escape() 函數轉換成跳脫序列的所有字元。

注意：請使用 encodeURIComponent() 函數取代 escape() 函數，以便將特殊分隔符號字元 (@ + /) 視為一般文字來編碼。

參數

相關 API 元素

會將指定的數值轉換成整數值。十進位值會在小數點處截斷。

參數

相關 API 元素

如果值是有限數字，則傳回 true；如果值是 Infinity 或 -Infinity，則傳回 false。正無限大或負無限大表示發生數學運算上的錯誤狀況，如除以 0。

參數

如果值是 NaN NaN (非數字)，則會傳回 true。isNaN() 函數有助於檢查數學運算式是否成功地評估為數字。isNaN() 最常見的用法是檢查 parseInt() 和 parseFloat() 函數傳回的值。NaN 值是 Number 資料類型的特殊成員，代表「不是數字」的值。

注意：NaN 值不是 int 或 uint 資料類型的成員。

下表說明各種輸入類型與值中的 isNaN() 傳回值 (如果您的編譯器警告設定為「嚴謹模式」，下列有些作業會產生編譯器警告)。

參數

會判斷指定的字串是否為 XML 元素或屬性的有效名稱。

參數

會將指定的值轉換成 Number 值。下表顯示各種輸入類型的結果：

參數

ActionScript 3.0 中的每個值都是物件，這表示針對某個值呼叫 Object() 時，便會傳回該值。

參數

將字串轉換成浮點數。這個函數會讀取或「剖析」字串中的數字，並在讀取到不屬於此最初數字的字元前，傳回字串中的數字。如果這個字串的開頭是無法剖析的數字，parseFloat() 便會傳回 NaN。會忽略有效整數前面的空白字元與結尾的非數值字元。

參數

將字串轉換成整數。如果參數中指定的字串無法轉換成數字，這個函數便會傳回 NaN。以 0x 開頭的字串會解譯成十六進位的數字，不同於先前版本的 ActionScript，從 0 開始的整數「不會」 解譯為八進位數字。您必須針對八進位數字，將基數指定為 8。有效整數前面的空白字元與零，以及結尾的非數值字元都會遭到忽略。

參數

傳回指定參數的字串表示法。

下表顯示各種輸入類型的結果：

參數

會在除錯時顯示運算式，或是寫入到記錄檔中。單一 trace 陳述式可支援多個引數。如果 trace 陳述式中的任何引數包括不同於 String 的資料類型，追蹤函數便會叫用與該資料類型相關聯的 toString() 方法。例如，如果引數是 Boolean 值，追蹤函數便會叫用 Boolean.toString() 並顯示傳回值。

參數

package {
    import flash.display.Sprite;

    public class TraceExample extends Sprite {

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

會將指定的數值轉換成無正負號的整數值。十進位值會在小數點處截斷。

下表說明各種輸入類型與值中的 uint() 傳回值。

參數

相關 API 元素

將參數 str 評估為字串、將 URL 編碼格式的字串解碼 (將所有十六進位序列轉換成 ASCII 字元)，然後傳回字串。

參數

建立新的 Vector 實體，其中的元素都是指定之資料類型的實體。呼叫這個函數時，您可以使用類型參數來指定結果 Vector 之元素的資料類型 (Vector 的「基底類型」)。這個函數使用的語法與宣告 Vector 實體或呼叫 new Vector.<T>() 建構函式時所使用的語法相同：

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

sourceArray 引數之元素中的值會填入結果 Vector。如果 sourceArray 引數已經是 Vector.<T> 實體 (其中 T 為基底類型)，此函數會傳回該 Vector。否則就會將 sourceArray Array 或 Vector 的元素填入結果 Vector。

在這兩種情況下，sourceArray 引數之所有元素的資料類型都必須符合函數呼叫中指定的基底類型 T。

如果 sourceArray 引數有 length 0，此函數會傳回空白 Vector。

如果 Vector 當做 sourceArray 引數傳遞而且其基底類型不是 T，或者如果傳遞 Array 而且其元素並不全都是資料類型 T 的實體，則會嘗試將值轉換為基底類型。如果值可以自動轉換，結果 Vector 會包含轉換後的值。如果無法進行轉換，則會發生錯誤。

同樣地，如果 sourceArray 引數中的元素是基底類型 T 之子類別的實體，呼叫會成功而且元素會加入至結果 Vector。即使 sourceArray 引數是基底類型為 T 之子類別的 Vector，這個做法也會成功。事實上，這是將基底類型 T 的 Vector 轉換為基底類型為 T 之父類別的 Vector 的唯一方式。

例如，下列程式碼會在嚴謹模式下產生編譯錯誤或在執行階段產生 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 元素