顶级
public final class int
继承int Inheritance Object

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

通过 int 类可使用表示为 32 位带符号整数的数据类型。int 类表示的值的范围是:-2,147,483,648 (-2^31) 到 2,147,483,647 (2^31-1)。

int 类的常数属性 MAX_VALUEMIN_VALUE 为静态的,这意味着无需对象就可使用这些属性,因而不需要使用构造函数。而方法却不是静态的,这意味着需要对象才能使用它们。可以通过使用 int 类构造函数,或者声明一个 int 类型的变量并赋予该变量一个文字值来创建 int 对象。

int 数据类型对于循环计数器以及不需要浮点数的其它场合很有用,它类似于 Java 和 C++ 中的 int 数据类型。 int 类型变量的默认值为 0

如果您正在处理超过 int.MAX_VALUE 的数值,可考虑使用 Number。

以下示例调用 int 类的 toString() 方法,以返回字符串 1234

 var myint:int = 1234;
 myint.toString();
 

以下示例将 MIN_VALUE 属性的值分配给一个无需使用构造函数进行声明的变量:

 var smallest:int = int.MIN_VALUE;
 

查看示例

另请参见

uint
Number
Data type descriptions
Type conversions


公共属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
公共方法
 方法定义方
  
int(num:Object)
构造函数;创建新的 int 对象。
int
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
  
toExponential(fractionDigits:uint):String
返回数字的字符串表示形式(采用指数表示法)。
int
  
toFixed(fractionDigits:uint):String
返回数字的字符串表示形式(采用定点表示法)。
int
  
返回数字的字符串表示形式(采用指数表示法或定点表示法)。
int
  
返回 int 对象的字符串表示形式。
int
  
返回指定 int 对象的原始值。
int
公共常量
 常量定义方
  MAX_VALUE : int = 2147483647
[静态] 可表示的最大 32 位带符号整数为 2,147,483,647。
int
  MIN_VALUE : int = -2147483648
[静态] 可表示的最小 32 位带符号整数为 -2,147,483,648。
int
构造函数详细信息
int()构造函数
public function int(num:Object)

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

构造函数;创建新的 int 对象。 使用 int.toString()int.valueOf() 时,必须使用 int 构造函数。使用 int 对象的属性时,不要使用构造函数。new int 构造函数主要用作占位符。int 对象与 int() 函数不同,后者将参数转换为原始值。

参数
num:Object — 要创建的 int 对象的数值,或者要转换为数字的值。如果未提供 value,则默认值为 0。

另请参见


示例
如何使用示例
以下代码构造新的 int 对象:
  var n1:int = new int(3.4);
  var n2:int = new int(-10);
  
方法详细信息
toExponential()方法
AS3 function toExponential(fractionDigits:uint):String

返回数字的字符串表示形式(采用指数表示法)。字符串在小数点前面包含一位,在小数点后面最多包含 20 位(在 fractionDigits 参数中指定)。

参数

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

返回数字的字符串表示形式(采用定点表示法)。定点表示法是指字符串的小数点后面包含特定的位数(在 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) 如何返回添加尾随 0 的字符串。

var num:Number = 4;
trace(num.toFixed(2)); // 4.00
toPrecision()方法 
AS3 function toPrecision(precision:uint):String

返回数字的字符串表示形式(采用指数表示法或定点表示法)。字符串将包含 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

返回 int 对象的字符串表示形式。

参数

radix:uint — 指定要用于数字到字符串的转换的基数(从 2 到 36)。如果未指定 radix 参数,则默认值为 10。

返回
String — 字符串。

示例
如何使用示例
下面的示例将 2 和 8 用于 radix 参数,并返回包含数字 9 的相应表示形式的字符串:
  var myint:int = new int(9);
  trace(myint.toString(2)); // 1001
  trace(myint.toString(8)); // 11
  

下面的示例生成十六进制值。

  var r:int = new int(250);
  var g:int = new int(128);
  var b:int = new int(114);
  var rgb:String = "0x"+ r.toString(16)+g.toString(16)+b.toString(16);
  trace(rgb); // 0xfa8072
  
valueOf()方法 
AS3 function valueOf():int

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

返回指定 int 对象的原始值。

返回
int — int 值。

示例
如何使用示例
下面的示例生成 numSocks 对象的原始值。
  var numSocks:int = new int(2);
  trace(numSocks.valueOf()); // 2
  
常量详细信息
MAX_VALUE常量
public static const MAX_VALUE:int = 2147483647

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

可表示的最大 32 位带符号整数为 2,147,483,647。


示例
如何使用示例
以下 ActionScript 在日志文件写入可表示的最大和最小 int 对象:
 trace("int.MIN_VALUE = "+int.MIN_VALUE);
 trace("int.MAX_VALUE = "+int.MAX_VALUE);
 

此代码记录下列值:

 int.MIN_VALUE = -2147483648
 int.MAX_VALUE = 2147483647
 
MIN_VALUE常量 
public static const MIN_VALUE:int = -2147483648

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

可表示的最小 32 位带符号整数为 -2,147,483,648。


示例
如何使用示例
以下 ActionScript 在日志文件写入可表示的最大和最小 int 对象:
     trace("int.MIN_VALUE = "+int.MIN_VALUE);
     trace("int.MAX_VALUE = "+int.MAX_VALUE);
     

此代码记录下列值:

 int.MIN_VALUE = -2147483648
 int.MAX_VALUE = 2147483647
     
示例 如何使用示例
IntExample.as

下面的示例使用 IntExample 类显示如何使用和检查 int 数据类型的有效性:
  1. 在构造函数中声明两个 int 变量 ab
  2. 添加两个 int(使用方法 addIntegers())。
  3. parseInteger()(它检查传递给它的字符串的有效性,并确保其为 int 数据类型可接受范围内的一个整数值,如果该字符串有效,则返回一个等于该字符串整数值的整数)的结果赋予第三个 int 变量 c
  4. 使用 addIntegers() 将 int 变量 ac 相加。
package {
    import flash.display.Sprite;

    public class IntExample extends Sprite {    
        public function IntExample() {
            var a:int = 512;
            var b:int = -128;
            
            trace(addIntegers(a, b)); // 384

            var c:int = parseInteger("32");
            
            trace(addIntegers(a, c)); // 544
        }
            
        public function addIntegers(a:int, b:int):int {
            return a + b;
        }
        
        public function parseInteger(str:String):int {
            var num:Number = parseInt(str);
            if(!isNaN(num) && num <= int.MAX_VALUE && num >= int.MIN_VALUE) {
                return int(num);
            }
            
            return 0;
        }
        
    }
}