类 java.lang.Long

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

public final class Long

extends Number

Long 类在其对象中封装了一个基本类型 long 型的值 。 每个 Long 型对象都包含一个 long 型的域。

另外，该类提供了许多方法，将 long 型转换为 String 型，或将 String 型转换为 long 型 ，还包含了处理 long 型时的其它一些有用的常量和方法。

变量索引

MAX_VALUE

类型 long 的最大值 。

MIN_VALUE

类型 long 的最小值 。

TYPE

描述基本类型中长型(数)的类的对象。

构造子索引

Long(long)

构造一新分配的 Long 对象，表示给定的基本类型的参数 long 。

Long(String)

构造一新分配的 Long 对象，表示给定字符串对应的值。

方法索引

byteValue()

以字节的形式返回 Long 对象的值。

doubleValue()

返回 Long 对象的双精度型值。

equals(Object)

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

floatValue()

返回 Long 对象的浮点值。

getLong(String)

用指定的名称确定系统属性的 long 值

getLong(String, Long)

用指定名确定系统属性的 long 值

getLong(String, long)

用指定名确定系统属性的 long 值

hashCode()

计算该 Long 类的散列码。

intValue()

返回 Long 对象的整数值。

longValue()

返回 Long 对象的长整数型值。

parseLong(String)

以有符号的十进制 long 的形式分析字符参数串 。

parseLong(String, int)

以由第二个参数指定数为基数的有符号的 long 的型来分析字符串参数 。

shortValue()

返回 Long 对象的短整数型值。

toBinaryString(long)

以在base 2 中无符号整数的形式生成该长整型参数的字符串表示。

toHexString(long)

以在 base 16 中无符号整数的形式生成该长整型参数的字符串表示。

toOctalString(long)

以在 base 8 中无符号整数的形式生成该长整型参数的字符串表示。

toString()

返回一个表示此 Long 对象的值的字符串对象。

toString(long)

返回表示指定整值的一个新的串对象。

toString(long, int)

生成由第二个参数指定的数为基数的第一个参数的字符串表示 。

valueOf(String)

返回由指定的字符串初始化的新的 Long 对象 。

valueOf(String, int)

返回由指定的字符串初始化的新的 Long 对象 。

变量

 public static final long MIN_VALUE

类型 long 的最小值 。

 public static final long MAX_VALUE

类型 long 的最大值 。

 public static final Class TYPE

此 Class 对象表示一个原始类型 long 。

构造子

 public Long(long value)

构造一新分配的 Long 对象，表示给定的基本类型的参数 long 。

参数：

value - Long 对象表示的值。

 public Long(String s) throws NumberFormatException

构造一新分配的 Long 对象，表示给定字符串对应的值。 该字符串好象调用 valueOf 方法被转换成 long 型值。

参数：

s - 要被转换曾 Long 的字符串。

抛出： NumberFormatException

如果该 String 不包含可分析的长整数。

参见：

valueOf

方法

 public static String toString(long i,
                               int radix)

生成在由第二个参数指定的数为基数的第一个参数的字符串表示 。

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

如果第一个参数是负数，则结果的第一个元素是 ASCII 符号 '-' 。 如果第一个参数非负， 结果中将不出现符号字符。下列 ASCII 字符用来作为数字：

0123456789abcdefghijklmnopqrstuvwxyz

参数：

i - 一长整数 。

radix - 基数。

返回：

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

参见：

MAX_RADIX, MIN_RADIX

 public static String toHexString(long i)

以在 base 16 中无符号整数的形式生成该长整型参数的字符串表示。

如果参数为负数，则该无符号长整数的值为该参数加上 2⁶⁴ ；否则，它等于该参数。 此值转换为 16 进制下不带前缀 0 的 ASCII 数字串 。

参数：

i - 一 long 。

返回：

由 16 进制(base 16) 表示的参数的无符号长整数值的字符串表示 。

 public static String toOctalString(long i)

以在 base 8 中无符号整数的形式生成该长整型参数的字符串表示。

如果参数为负数，则该无符号长整数的值为该参数加上 2⁶⁴ ； 否则，它等于该参数。 此值转换为 8 进制下不带前缀 0 的 ASCII 数字串。

参数：

i - 一 long 。

返回：

由 8 进制(base 8) 参数的无符号长整数值的字符串表示。

 public static String toBinaryString(long i)

以在 base 2 中无符号整数的形式生成该长整型参数的字符串表示。

如果参数为负数，则该无符号长整数的值为该参数加上 2⁶⁴ ) ；否则，它等于该参数。 此值转换为 2 进制(base 2)下不带前缀 0 的 ASCII 数字串 。

参数：

i - 一长整数 。

返回：

由 2 进制(base 2) 参数的无符号长整数值的字符串表示 。

 public static String toString(long i)

返回表示指定整值的一个新的字符串对象。 假定为 10 进制。

参数：

i -转换的 long 。

返回：

在 base 10 中参数的字符串表示 。

 public static long parseLong(String s,
                              int radix) throws NumberFormatException

分析由第二个参数指定的数为基数的有符号 long 表示的字符串参数 。字符串中的字符必须为指定基数中的数(由 Character.digit 返回是否为非负来决定)，除非第一个字符为 ASCII 字符减号'-' ，它表示一个负数。 返回 long 型值结果。

参数：

s - String 中包含 long 。

radix - 使用的进制

返回：

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

抛出： NumberFormatException

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

 public static long parseLong(String s) throws NumberFormatException

以有符号的十进制long 的形式分析字符参数串 。 字符串中的字符必须为 10 进制数 ，除非第一个字符为 ASCII 字符减号 '-' ，它表示一个负数 。

参数：

s - 串。

返回：

由 10 进制参数表示的 long 。

抛出： NumberFormatException

如果该字符串不包含一个可分析的 long 型值。

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

返回由指定的字符串初始化的新的 Long 对象。如果该串不能以 长整型分析，则抛出异常。

参数：

s - String 中包含 long 。

radix - 使用的进制

返回：

一新创建的 Long 对象，初始化为 String 参数对应的浮点值。

抛出： NumberFormatException

如果 String 不包含可分析的 long 。

 public static Long valueOf(String s) throws NumberFormatException

返回由指定的字符串初始化的新的 Long 对象。如果该串不能以 长整型分析，则抛出异常。 假定是 10 进制表示。

参数：

s - 待分析的字符串。

返回：

一新创建的 Long 对象，初始化为 字符串参数表示的值。

抛出： NumberFormatException

如果 String 不包含可分析的 long 型值。

 public byte byteValue()

以 byte 的形式返回 Long 对象的值。

覆盖：

类 Number 中的 byteValue

 public short shortValue()

以 short 型返回 Long 对象的值。

覆盖：

类 Number 中的 shortValue

 public int intValue()

以 int 型返回 Long 对象的值。

返回：

将对象表示的 long 值转换成 int 型值，且返回此结果。

覆盖：

类 Number 中的 intValue

 public long longValue()

以 long 型返回 Long 对象的值。

返回：

对象表示的 long 型值。

覆盖：

类 Number 中的 longValue

 public float floatValue()

以 float 型返回 Long 对象的值。

返回：

将对象表示的 long 型值转换成 float 型值，且返回此结果。

覆盖：

类 Number 中的 floatValue

 public double doubleValue()

以 double 型返回 Long 对象的值。

返回：

将对象表示的 long 型值转换成 double 型值，且返回转换后的结果。

覆盖：

类 Number 中的 doubleValue

 public String toString()

返回一个表示此 Long 对象值的 String 对象。

返回：

在 base 10 中的该对象的字符串表示。

覆盖：

类 Object 中的 toString

 public int hashCode()

计算该 Long 类的散列码。

返回：

该对象的哈希值。

覆盖：

类 Object 中的 hashCode

 public boolean equals(Object obj)

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

参数：

obj - 比较的对象。

返回：

如果是对象相同则为 true ，否则为 false 。

覆盖：

类 Object 中的 equals

 public static Long getLong(String nm)

用指定名称确定系统属性的 long 值。

第一个参数作为系统属性的名称来处理。 通过调用 getProperty 方法可访问系统属性，此方法在 System 类中定义。 其后，该属性的字符串值被解释为一 长整数，并且返回表示该值的 Long 对象 。 可能数字格式的详细资料可以在 getProperty 的定义中查找 。

如果不存在指定名字的属性，或者该属性不具有正确的数字格式， 则返回 null 。

参数：

nm - 属性名 。

返回：

属性的 Long 值 。

参见：

getProperty, getProperty

 public static Long getLong(String nm,
                            long val)

用指定名称确定系统属性的 long 值。

第一个参数作为系统属性的名称来处理。 通过调用 getProperty 方法可访问系统属性，此方法在 System 类中定义。 其后，该属性的字符串值被解释为一 长整数，并且返回表示该值的 Long 对象。 可能的数字格式的详细资料可以在 getProperty 的定义中查找 。

如果不存在指定的属性，或者该属性不具有正确的数字格式， 则返回表示第二个参数的 Long 对象。

参数：

nm - 属性名 。

val - 缺省值 。

返回：

属性的 Long 值 。

参见：

getProperty, getProperty

 public static Long getLong(String nm,
                            Long val)

用指定名称确定系统属性的 long 值。

第一个参数作为系统属性的名称来处理。 通过调用 getProperty 方法可访问系统属性，此方法在 System 类中定义。 其后，该属性的字符串值被解释为一 长整数，并且返回表示该值的 Long 对象。

如果属性值以 "0x" 或 "#" 打头，并且后面不跟有负号，则剩余的部分可以象方法 Long.valueOf 分析 16 进制数一样来分析。

如果属性值以"0" 打头 ，则它可以象方法 Long.valueOf 分析 8 进制数一样来分析。

否则该属性值将以 10 进制整数分析，正如用基于 10 进制的方法 Long.valueOf来进行分析一样。

注意任何情况下，L 和 l 都不能出现在字符串的尾部。

第二个参数为缺省(默认)值 。 如果不存在指定名字的属性，或者该属性不具有正确的数字格式， 则返回第二个参数。

参数：

nm - 属性名 。

val - 缺省的 Long 值 。

返回：

属性的 long 值 。

参见：

valueOf, getProperty, getProperty