Package | Top Level |
Class | public final class uint |
Inheritance | uint Object |
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.0 |
The range of values represented by the uint class is 0 to 4,294,967,295 (2^32-1).
You can create a uint object by declaring a variable of type uint and assigning the variable a literal value. The default value of a variable of type uint is 0
.
The uint class is primarily useful for pixel color values (ARGB and RGBA) and other situations where the int data type does not work well. For example, the number 0xFFFFFFFF, which represents the color value white with an alpha value of 255, can't be represented using the int data type because it is not within the valid range of the int values.
The following example creates a uint object and calls the
toString()
method:
var myuint:uint = 1234; trace(myuint.toString()); // 1234
The following example assigns the value of the MIN_VALUE
property to a variable without the use of the constructor:
var smallest:uint = uint.MIN_VALUE; trace(smallest.toString()); // 0
See also
Method | Defined By | ||
---|---|---|---|
Creates a new uint object. | uint | ||
Indicates whether an object has a specified property defined. | Object | ||
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter. | Object | ||
Indicates whether the specified property exists and is enumerable. | Object | ||
Sets the availability of a dynamic property for loop operations. | Object | ||
Returns a string representation of the number in exponential notation. | uint | ||
Returns a string representation of the number in fixed-point notation. | uint | ||
Returns the string representation of this object, formatted according to locale-specific conventions. | Object | ||
Returns a string representation of the number either in exponential notation or in
fixed-point notation. | uint | ||
Returns the string representation of a uint object. | uint | ||
Returns the primitive uint type value of the specified
uint object. | uint |
Constant | Defined By | ||
---|---|---|---|
MAX_VALUE : uint = 4294967295 [static]
The largest representable 32-bit unsigned integer, which is 4,294,967,295. | uint | ||
MIN_VALUE : uint = 0 [static]
The smallest representable unsigned integer, which is 0. | uint |
uint | () | Constructor |
public function uint(num:Object)
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.0 |
Creates a new uint object. You can create a variable of uint type and assign it a literal value. The new uint()
constructor is primarily used
as a placeholder. A uint object is not the same as the
uint()
function, which converts a parameter to a primitive value.
num:Object — The numeric value of the uint object being created,
or a value to be converted to a number. If num is not provided,
the default value is 0 .
|
Example
How to use this example
The following code constructs two new uint objects; the first by assigning a literal value, and the second by using the constructor function:
var n1:uint = 3; var n2:uint = new uint(10);
toExponential | () | method |
AS3 function toExponential(fractionDigits:uint):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.0 |
Returns a string representation of the number in exponential notation. The string contains
one digit before the decimal point and up to 20 digits after the decimal point, as
specified by the fractionDigits
parameter.
Parameters
fractionDigits:uint — An integer between 0 and 20, inclusive, that represents the desired number of decimal places.
|
String |
Throws
RangeError — Throws an exception if the fractionDigits argument is outside the range 0 to 20.
|
Example ( How to use this example )
toExponential(2)
returns a string in
exponential notation.
var num:Number = 315003; trace(num.toExponential(2)); // 3.15e+5
toFixed | () | method |
AS3 function toFixed(fractionDigits:uint):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.0 |
Returns a string representation of the number in fixed-point notation.
Fixed-point notation means that the string will contain a specific number of digits
after the decimal point, as specified in the fractionDigits
parameter.
The valid range for the fractionDigits
parameter is from 0 to 20.
Specifying a value outside this range throws an exception.
Parameters
fractionDigits:uint — An integer between 0 and 20, inclusive, that represents the desired number of decimal places.
|
String |
Throws
RangeError — Throws an exception if the fractionDigits argument is outside the range 0 to 20.
|
Example ( How to use this example )
toFixed(3)
returns a string that rounds
to three decimal places.
var num:Number = 7.31343; trace(num.toFixed(3)); // 7.313
toFixed(2)
returns a string that adds
trailing zeroes.
var num:Number = 4; trace(num.toFixed(2)); // 4.00
toPrecision | () | method |
AS3 function toPrecision(precision:uint):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.0 |
Returns a string representation of the number either in exponential notation or in
fixed-point notation. The string will contain the number of digits specified in the
precision
parameter.
Parameters
precision:uint — An integer between 1 and 21, inclusive, that represents the desired number of digits to represent in the resulting string.
|
String |
Throws
RangeError — Throws an exception if the precision argument is outside the range 1 to 21.
|
Example ( How to use this example )
toPrecision(3)
returns a string with
only three digits. The string is in fixed-point notation because exponential notation is not required.
var num:Number = 31.570; trace(num.toPrecision(3)); // 31.6
toPrecision(3)
returns a string with
only three digits. The string is in exponential notation because the resulting number does not
contain enough digits for fixed-point notation.
var num:Number = 4000; trace(num.toPrecision(3)); // 4.00e+3
toString | () | method |
AS3 function toString(radix:uint):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.0 |
Returns the string representation of a uint object.
Parameters
radix:uint — Specifies the numeric base (from 2 to 36) to use for the
number-to-string conversion. If you do not specify the radix
parameter, the default value is 10 .
|
String — The string representation of the uint object.
|
Example
How to use this example
The following example uses 2 and 8 for the
radix
parameters and returns a string value with the corresponding
representation of the number 9:
var myuint:uint = 9; trace(myuint.toString(2)); // 1001 trace(myuint.toString(8)); // 11The following example creates hexadecimal values:
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 | () | method |
AS3 function valueOf():uint
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.0 |
Returns the primitive uint type value of the specified uint object.
Returnsuint — The primitive uint type value of this uint
object.
|
Example
How to use this example
The following example outputs the primitive value of the
numSocks
object.
var numSocks:uint = 2; trace(numSocks.valueOf()); // 2
MAX_VALUE | Constant |
public static const MAX_VALUE:uint = 4294967295
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.0 |
The largest representable 32-bit unsigned integer, which is 4,294,967,295.
Example
How to use this example
The following ActionScript displays the largest and smallest representable
uint
values:
trace("uint.MIN_VALUE = " + uint.MIN_VALUE); trace("uint.MAX_VALUE = " + uint.MAX_VALUE);
The values are:
uint.MIN_VALUE = 0 uint.MAX_VALUE = 4294967295
MIN_VALUE | Constant |
public static const MIN_VALUE:uint = 0
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.0 |
The smallest representable unsigned integer, which is 0
.
Example
How to use this example
The following ActionScript displays the largest and smallest representable
uint
values:
trace("uint.MIN_VALUE = " + uint.MIN_VALUE); trace("uint.MAX_VALUE = " + uint.MAX_VALUE);
The values are:
uint.MIN_VALUE = 0 uint.MAX_VALUE = 4294967295
i
within a for
loop,
which prints out the digits 0 to 9 (since uint defaults to 0).
package { import flash.display.Sprite; public class UintExample extends Sprite { public function UintExample() { for(var i:uint; i < 10; i++) { trace(i); } } } }
Fri Mar 19 2010, 02:45 AM -07:00