uint

套件	最上層
類別	public final class uint
繼承	uint 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 元素

公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		uint(num:Object) 會建立新的 uint 物件。	uint
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		toExponential(fractionDigits:uint):String 使用指數標記法傳回數字的字串形式。	uint
		toFixed(fractionDigits:uint):String 會使用定點標記法傳回數字的字串形式。	uint
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toPrecision(precision:uint):String 會使用指數標記法或定點標記法，傳回數字的字串形式。	uint
		toString(radix:uint):String 會傳回 uint 物件的字串形式。	uint
		valueOf():uint 會傳回指定之 uint 物件的基本 uint 類型值。	uint

公用常數

	常數		定義自
		MAX_VALUE : uint = 4294967295 [靜態] 可表示之 32 位元的最大無正負號整數，也就是 4,294,967,295。	uint
		MIN_VALUE : uint = 0 [靜態] 可表示的最小無正負號整數，也就是 0。	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);
            }
        }
    }
}

法律聲明 | 線上隱私權政策

uint - AS3

類別 x

uint

toExponential

toFixed

toPrecision

toString

valueOf

MAX_VALUE

MIN_VALUE