| Language version: | ActionScript 3.0
|
The uint class provides methods for working with a data type representing a 32-bit unsigned integer. Because an unsigned integer can only be
positive, its maximum value is twice that of the int class.
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
View the examples.
public function uint(num:Object)
| Language version: | ActionScript 3.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.
Parameters
| 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
AS3 function toExponential(fractionDigits:uint):String
| Language version: | ActionScript 3.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.
|
Returns
Throws
| RangeError — Throws an exception if the fractionDigits argument is outside the range 0 to 20.
|
Example
The following example shows how
toExponential(2) returns a string in
exponential notation.
var num:Number = 315003;
trace(num.toExponential(2)); // 3.15e+5
AS3 function toFixed(fractionDigits:uint):String
| Language version: | ActionScript 3.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.
|
Returns
Throws
| RangeError — Throws an exception if the fractionDigits argument is outside the range 0 to 20.
|
Example
The following example shows how
toFixed(3) returns a string that rounds
to three decimal places.
var num:Number = 7.31343;
trace(num.toFixed(3)); // 7.313
The following example shows how
toFixed(2) returns a string that adds
trailing zeroes.
var num:Number = 4;
trace(num.toFixed(2)); // 4.00
AS3 function toPrecision(precision:uint):String
| Language version: | ActionScript 3.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.
|
Returns
Throws
| RangeError — Throws an exception if the precision argument is outside the range 1 to 21.
|
Example
The following example shows how
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
The following example shows how
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
AS3 function toString(radix:uint):String
| Language version: | ActionScript 3.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.
|
Returns
| String —
The string representation of the uint object.
|
Example
AS3 function valueOf():uint
| Language version: | ActionScript 3.0
|
Returns the primitive uint type value of the specified
uint object.
Returns
| uint —
The primitive uint type value of this uint
object.
|
Example
public static const MAX_VALUE:uint = 4294967295
| Language version: | ActionScript 3.0
|
The largest representable 32-bit unsigned integer, which is 4,294,967,295.
Example
public static const MIN_VALUE:uint = 0
| Language version: | ActionScript 3.0
|
The smallest representable unsigned integer, which is 0.
Example
The following example declares a uint
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);
}
}
}
}
© 2004-2022 Adobe Systems Incorporated. All rights reserved.
Wed Sep 28 2022, 6:12 PM GMT+01:00
Object
Hide Inherited Public Properties
Show Inherited Public Properties