適用於 Adobe® Flash® Platform 的 ActionScript® 3.0 參考
首頁  |  隱藏套件和類別清單 |  套件  |  類別  |  新增內容  |  索引  |  附錄  |  為什麼顯示英文?
篩選: 從伺服器擷取資料...
從伺服器擷取資料...
最上層 

uint  - AS3

套件最上層
類別public final class uint
繼承uint Inheritance Object

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

uint 類別會提供方法來處理代表 32 位元無正負號之整數的資料類型。 由於無正負號的整數只能是正值,所以其最大值會是 int 類別的兩倍。

uint 類別代表之值的範圍會從 0 到 4,294,967,295 (2^32-1)。

您可以宣告 uint 類型的變數,並對該變數指派常值以建立 uint 物件。 uint 類型之變數的預設值為 0

uint 類別主要用於像素顏色值 (ARGB 與 RGBA),以及 int 資料類型並不適合的其他狀況。例如,代表白色顏色值並具有 255 之 Alpha 值的數字 0xFFFFFFFF,就不能以 int 資料類型代表,這是因為該值並不位於 int 值的有效範圍內。

下列範例會建立 uint 物件,並呼叫 toString() 方法:

 var myuint:uint = 1234;
 trace(myuint.toString()); // 1234
 

下列範例會將 MIN_VALUE 屬性的值指定給變數,而不使用建構函式:

 var smallest:uint = uint.MIN_VALUE;
 trace(smallest.toString()); // 0
 

檢視範例

相關 API 元素



公用屬性
 屬性定義自
 Inheritedconstructor : Object
類別物件的參照或是特定物件實體的建構函數。
Object
公用方法
 方法定義自
  
會建立新的 uint 物件。
uint
 Inherited
指出物件是否有已定義的指定屬性。
Object
 Inherited
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。
Object
 Inherited
指出指定的屬性是否存在,以及是否可列舉。
Object
 Inherited
為迴圈作業設定動態屬性的可用性。
Object
  
toExponential(fractionDigits:uint):String
使用指數標記法傳回數字的字串形式。
uint
  
toFixed(fractionDigits:uint):String
會使用定點標記法傳回數字的字串形式。
uint
 Inherited
傳回代表此物件的字串,根據地區特定慣例進行格式化。
Object
  
會使用指數標記法或定點標記法,傳回數字的字串形式。
uint
  
會傳回 uint 物件的字串形式。
uint
  
會傳回指定之 uint 物件的基本 uint 類型值。
uint
公用常數
 常數定義自
  MAX_VALUE : uint = 4294967295
[靜態] 可表示之 32 位元的最大無正負號整數,也就是 4,294,967,295。
uint
  MIN_VALUE : uint = 0
[靜態] 可表示的最小無正負號整數,也就是 0。
uint
建構函式詳細資料

uint

()建構函式
public function uint(num:Object)

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

會建立新的 uint 物件。 您可以建立 uint 類型的變數,並對其指派常值。 new uint() 建構函式主要做為預留位置之用。 uint 物件不同於將參數轉換成基本值的 uint() 函數。

參數
num:Object — 所建立之 uint 物件的數值,或是要轉換成數字的值。 如果沒有提供 num,預設值會是 0

範例
如何使用本範例
下列程式碼會建構兩個新的 uint 物件:第一個物件的建構方式是指派常值,而第二個物件則是使用建構函數:
	 var n1:uint = 3;
	 var n2:uint = new uint(10);
	 
方法詳細資訊

toExponential

()方法
AS3 function toExponential(fractionDigits:uint):String

語言版本: ActionScript 3.0
執行階段版本: Flash Player 9, AIR 1.0, Flash Lite 4

使用指數標記法傳回數字的字串形式。 所謂指數標記法,就是字串會依照 fractionDigits 參數的指定方式,只在小數點前包含一位數,而在小數點後最多可包含 20 位數。

參數

fractionDigits:uint — 介於 0 到 20 之間的整數 (含上下限),代表所需的小數位數。

傳回值
String

擲回值
RangeError — 如果 fractionDigits 引數在 0 到 20 的範圍外,則會擲回例外。

範例  ( 如何使用本範例 )

下列範例會示範 toExponential(2) 如何在指數標記法中傳回字串。
var num:Number = 315003;
trace(num.toExponential(2)); // 3.15e+5

toFixed

()方法 
AS3 function toFixed(fractionDigits:uint):String

語言版本: ActionScript 3.0
執行階段版本: Flash Player 9, AIR 1.0, Flash Lite 4

會使用定點標記法傳回數字的字串形式。 所謂定點標記法,就是字串會依照 fractionDigits 參數中的指定方式,在小數點後包含特定數目的位數。 fractionDigits 參數有效的範圍是從 0 到 20。 指定這個範圍以外的值會擲回例外。

參數

fractionDigits:uint — 介於 0 到 20 之間的整數 (含上下限),代表所需的小數位數。

傳回值
String

擲回值
RangeError — 如果 fractionDigits 引數在 0 到 20 的範圍外,則會擲回例外。

範例  ( 如何使用本範例 )

下列範例會示範 toFixed(3) 如何傳回四捨五入為三位小數的字串。
var num:Number = 7.31343;
trace(num.toFixed(3)); // 7.313

下列範例會示範 toFixed(2) 如何傳回會加入結尾零的字串。
var num:Number = 4;
trace(num.toFixed(2)); // 4.00

toPrecision

()方法 
AS3 function toPrecision(precision:uint):String

語言版本: ActionScript 3.0
執行階段版本: Flash Player 9, AIR 1.0, Flash Lite 4

會使用指數標記法或定點標記法,傳回數字的字串形式。 此字串將會包含 precision 參數中指定的位數。

參數

precision:uint — 介於 1 與 21 之間的整數 (含上下限),代表產生的字串中所需的位數。

傳回值
String

擲回值
RangeError — 如果 precision 引數在 1 到 21 的範圍外,則會擲回例外。

範例  ( 如何使用本範例 )

下列範例會示範 toPrecision(3) 如何傳回只有三位數的字串。 此字串會使用定點標記法,因為在此並不需要指數標記法。
var num:Number = 31.570;
trace(num.toPrecision(3)); // 31.6

下列範例會示範 toPrecision(3) 如何傳回只有三位數的字串。 此字串是使用指數標記法,因為產生的數字未包含定點標記法所需的足夠位數。
var num:Number = 4000;
trace(num.toPrecision(3)); // 4.00e+3

toString

()方法 
AS3 function toString(radix:uint):String

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

會傳回 uint 物件的字串形式。

參數

radix:uint — 會指定用於數字到字串轉換的底數 (從 2 到 36)。 如果您沒有指定 radix 參數,預設值會是 10

傳回值
String — uint 物件的字串形式。

範例
如何使用本範例
下列範例會使用 2 和 8 做為 radix 參數,並傳回包含數字 9 之對應形式的字串值。
	 var myuint:uint = 9;
	 trace(myuint.toString(2)); // 1001
	 trace(myuint.toString(8)); // 11
	 
下列範例會建立十六進位值:
	 var r:uint = 250;
	 var g:uint = 128;
	 var b:uint = 114;
	 var rgb:String = "0x" + r.toString(16) + g.toString(16) + b.toString(16);
	 trace(rgb); // 0xfa8072 
	 

valueOf

()方法 
AS3 function valueOf():uint

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

會傳回指定之 uint 物件的基本 uint 類型值。

傳回值
uint — 此 uint 物件的基本 uint 類型值。

範例
如何使用本範例
下列範例會輸出 numSocks 物件的基本值。
	 var numSocks:uint = 2;
	 trace(numSocks.valueOf()); // 2
	 
常數詳細資訊

MAX_VALUE

常數
public static const MAX_VALUE:uint = 4294967295

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

可表示之 32 位元的最大無正負號整數,也就是 4,294,967,295。


範例
如何使用本範例
下列 ActionScript 會顯示可表示之 uint 的最大與最小值:
	trace("uint.MIN_VALUE = " + uint.MIN_VALUE);
	trace("uint.MAX_VALUE = " + uint.MAX_VALUE);
	

這些值為:

	uint.MIN_VALUE = 0
	uint.MAX_VALUE = 4294967295
	

MIN_VALUE

常數 
public static const MIN_VALUE:uint = 0

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

可表示的最小無正負號整數,也就是 0


範例
如何使用本範例
下列 ActionScript 會顯示可表示之 uint 的最大與最小值:
	 trace("uint.MIN_VALUE = " + uint.MIN_VALUE);
	 trace("uint.MAX_VALUE = " + uint.MAX_VALUE);
	 

這些值為:

	 uint.MIN_VALUE = 0
	 uint.MAX_VALUE = 4294967295
	 
UintExample.as

下列範例會在 for 迴圈內宣告 uint i,它會列印出 0 到 9 的數字 (因為 uint 預設值為 0)。
package {
    import flash.display.Sprite;

    public class UintExample extends Sprite {
        public function UintExample() {
            for(var i:uint; i < 10; i++) {
                trace(i);
            }
        }
    }
}




[ X ]為什麼顯示英文?
「ActionScript 3.0 參考」的內容是以英文顯示

並非所有「ActionScript 3.0 參考」的內容都翻譯為所有語言。當語言元素未翻譯時,就會以英文顯示。例如,ga.controls.HelpBox 類別並沒有翻譯為任何語言。因此在參考的繁體中文版本中,ga.controls.HelpBox 類別就會以英文顯示。