类 java.lang.Integer

java.lang.Object
   |
   +----java.lang.Number
           |
           +----java.lang.Integer

public final class Integer

extends Number

Integer 类在某对象中打包了原始类型为 int 的值。Integer 类型对象包含 int 型的单个域。

此外，此类提供了许多方法，可以将 int 型转换为 String 型并将 String 型转换为 int 型，也包含处理 int 类型时的其它有用常量和方法。

变量索引

MAX_VALUE

类型为 int 的最大值 。

MIN_VALUE

类型为 int 的最小值 。

TYPE

表示原始类型为 int 的 Class 对象。

构造子索引

Integer(int)

构造一个新分配的 Integer 对象，它表示原始 int 型参数。

Integer(String)

构造一个新分配的 Integer 对象，它代表字符串所表示的值。

方法索引

byteValue()

以 byte 类型返回该 Integer 的值。

decode(String)

将字符串译码成 Integer 。

doubleValue()

以 double 类型返回该 Integer 的值。

equals(Object)

将该对象与指定对象比较。

floatValue()

以 float 类型返回该 Integer 的值。

getInteger(String)

用指定名字来确定系统特性的整数值。

getInteger(String, int)

用指定名字来确定系统特性的整数值。

getInteger(String, Integer)

用指定名字来确定系统特性的整数值。

hashCode()

返回该 Integer 的散列码。

intValue()

以 int 类型返回该 Integer 的值。

longValue()

以 long 类型返回该 Integer 的值。

parseInt(String)

将字符串参数作为带符号十进制整数来分析。

parseInt(String, int)

以第二个参数所指定的基将字符串参数分析为一个带符号的整数。

shortValue()

以 short 类型返回该 Integer 的值。

toBinaryString(int)

创建一个整数参数的以  2 为基数的无符号整数的字符串表示。

toHexString(int)

创建一个整数参数的以  16 为基数的无符号整数的字符串表示。

toOctalString(int)

创建一个整数参数的以  8 为基数的无符号整数的字符串表示。

toString()

返回一个表示该 Integer 值的 String 对象。

toString(int)

返回表示指定整数的一个新 String 对象。

toString(int, int)

创建第二个参数指定基下的第一个参数的字符串表示 。

valueOf(String)

返回用指定 String 值初始化的新的 Integer 对象 。

valueOf(String, int)

返回用指定 String 值初始化的新的 Integer 对象 。

变量

 public static final int MIN_VALUE

类型为 int 的最小值 。

 public static final int MAX_VALUE

类型为 int 的最大值 。

 public static final Class TYPE

表示原始类型为 int 的 Class 对象。

构造子

 public Integer(int value)

构造一个新分配的 Integer 对象，它表示原始 int 参数。

参数：

value - Integer 表示的值。

 public Integer(String s) throws NumberFormatException

构造一个新分配的 Integer 对象，它代表字符串所表示的值。如同用 valueOf 方法，该字符串可转换为 int 值。

参数：

s - 待转换为 Integer 的 String 。

抛出： NumberFormatException

若 String不包含可分析的整数。

参见：

valueOf

方法

 public static String toString(int i,
                               int radix)

创建以第二个参数为基数的第一个参数的字符串表示 。

如果基数小于 Character.MIN_RADIX ，或大于 Character.MAX_RADIX ，则使用基数 10 。

若第一个参数是负数，则结果的第一个元素为 ASCII 的最小字符 '-' 。若第一个参数非负，则无符号字符出现在结果中。用下列 ASCII 字符作为数字：

0123456789abcdefghijklmnopqrstuvwxyz

参数：

i - 整数。

radix - 基数。

返回值：

指定基数下的参数的字符串表示 。

参见：

MAX_RADIX, MIN_RADIX

 public static String toHexString(int i)

创建一个整数参数的以  16 为基数的无符号整数的字符串表示。

若参数为负数，则该无符号整数值为参数加 2³² ；否则等于该参数 。将该值转换为十六进制 (基于  16) 的无附加前导 0 的 ASCII 数字串。

参数：

i - 整数。

返回值：

十六进制 (基于  16 ) 参数所表示的无符号整数值的字符串表示。

 public static String toOctalString(int i)

创建一个整数参数以  8 为基数的无符号整数的字符串表示。

若参数为负数，则该无符号整数值为参数加 2³² ；否则等于该参数 。将该值转换为十六进制 (基于  8) 无附加前导 0 的 ASCII 数字串。

参数：

i - 整数。

返回值：

八进制 (基于 &mnsp;8 ) 参数所表示的无符号整数值的字符串表示。

 public static String toBinaryString(int i)

创建一个整数参数以  2 为基数的无符号整数的字符串表示。

若参数为负数，则该无符号整数值为参数加 2³² ；否则等于该参数 。将该值转换为二进制 (基于  2 ) 的无附加前导 0 的 ASCII 数字串。

参数：

i - 整数。

返回值：

二进制 (基于  2 ) 参数所表示的无符号整数值的字符串表示。

 public static String toString(int i)

返回表示指定整数值的一个新的 String 对象。假设基数为 10 。

参数：

i - 待转换的整数。

返回值：

基于  10 的参数的字符串表示 。

 public static int parseInt(String s,
                            int radix) throws NumberFormatException

以第二个参数所指定基数将字符串参数分析为一个带符号的整数。除了第一个字符可以用 ASCII 的减号 '-' 来表示一个负值外，字符串中的字符必须是指定基数的数(由 Character.digit 是否返回非负值决定)。返回作为结果的整数值。

参数：

s - 包含整数的 String 。

radix - 使用的进制

返回值：

指定基数的字符串参数所表示的整数。

抛出： NumberFormatException

若该串不包含一个可分析的整数。

 public static int parseInt(String s) throws NumberFormatException

将字符串参数作为带符号十进制整数来分析。除过第一个字符为 ASCII 字符中减号 '-' 表示的负数，字符串中的字符都必须是十进制数。

参数：

s - 串。

返回值：

十进制参数表示的整数。

抛出： NumberFormatException

若该串不包含一个可分析的整数。

 public static Integer valueOf(String s,
                            int radix) throws NumberFormatException

返回初始化为指定 String 值的新的 Integer 对象。若该 String 不能作为 int 分析，则抛出异常。

参数：

s - 待分析的字符串。

返回值：

新创建的 Integer ，将其以指定基数初始化为字符串参数所表示的值。

抛出： NumberFormatException

若 String不包含可分析的整数。

 public static Integer valueOf(String s) throws NumberFormatException

返回初始化为指定 String 值的新的 Integer 对象。若该 String 不能作为 int 分析，则抛出异常。假设基数为 10 。

参数：

s - 待分析的字符串。

返回值：

新创建的 Integer ，将其初始化为字符串参数所表示的值。

抛出： NumberFormatException

如果该串不包含一个可分析的整数。

 public byte byteValue()

以 byte 类型返回该 Integer 的值。

覆盖：

类 Number 中的 byteValue

 public short shortValue()

以 short 类型返回该 Integer 的值。

覆盖：

类 Number 中的 shortValue

 public int intValue()

以 int 类型返回该 Integer 的值。

返回值：

该对象表示的 int 值。

覆盖：

类 Number 中的 intValue

 public long longValue()

以 long 类型返回该 Integer 的值。

返回值：

将该对象表示的 int 值转换成 long 型并返回转换结果。

覆盖：

类 Number 中的 longValue

 public float floatValue()

以 float 类型返回该 Integer 的值。

返回值：

将该对象表示的 int 值转换成 float 型值并返回转换结果。

覆盖：

类 Number 中的 floatValue

 public double doubleValue()

以 double 类型返回该 Integer 的值。

返回值：

将该对象表示的 int 值转换成 double 型值并返回转换结果。

覆盖：

类 Number 中的 doubleValue

 public String toString()

返回一个表示该 Integer 值的 String 对象。

返回值：

基于  10 的该对象值的字符串表示 。

覆盖：

类 Object 中的 toString

 public int hashCode()

返回该 Integer 的散列码。

返回值：

该对象的散列码。

覆盖：

类 Object 中的 hashCode

 public boolean equals(Object obj)

将该对象与指定对象比较。当且仅当参数不为 null 且是与该对象包含相同 int 值的 Integer 对象时，结果为 true 。

参数：

obj - 比较的对象。

返回值：

若对象是相同的则为 true ，否则为 false 。

覆盖：

类 Object 中的 equals

 public static Integer getInteger(String nm)

用指定名字来确定系统特性的整数值。

将第一个参数作为系统特性名。通过 getProperty 可访问系统特性，方法由 System 类定义。然后，将该特性的字符串值解释为整数，并且返回表示该值的 Integer 对象。可能的数字格式的详细资料可以在 getProperty 的定义中找到。

若无指定名字的特性或该特性无正确的数字格式，则返回 null 。

参数：

nm - 特性名。

返回值：

特性的 Integer 值。

参见：

getProperty, getProperty

 public static Integer getInteger(String nm,
                                  int val)

用指定名字来确定系统特性的整数值。

将第一个参数作为系统特性名。通过 getProperty 可访问系统特性，方法由System 类定义。然后，将该特性的字符串值解释为整数，并返回表示该值的 Integer 对象。可能的数字格式的详细资料可以在 getProperty 的定义中找到。

若无指定名字的特性或该特性无正确的数字格式，则返回表示第二个参数值的 Integer 。

参数：

nm - 特性名。

val - 缺省值 。

返回值：

特性的 Integer 值。

参见：

getProperty, getProperty

 public static Integer getInteger(String nm,
                                  Integer val)

用指定名字确定系统特性的整数值。

将第一个参数作为系统特性名。通过 getProperty 可访问系统特性，方法由System 类定义。然后，将该特性的字符串值解释为整数值，并返回表示该值的 Integer 对象。

若特性以“ 0x ” 或“ # ” 开头且后面不带负号，则其剩余部分作为十六进制整数分析与方法 Long.valueOf 分析 16 进制数一样。

若特性以“ 0 ”开头，则作为八进制整数分析，如同方法 Long.valueOf 分析八进制数一样。

否则该特性值将作为十进制整数分析，如同方法 Long.valueOf 分析十进制数一样。

第二个参数为缺省值。若无指定名字的特性或该特性无正确的数字格式，则返回第二个参数。

参数：

nm - 特性名。

val - 缺省值 。

返回值：

特性的 Integer 值。

参见：

getProperty, getProperty

 public static Integer decode(String nm) throws NumberFormatException

将字符串译码成 Integer 。该串可以表示十进制、十六进制和八进制数。

参数：

nm - 待译码的串