所有类

概述 软件包  类 使用 树 已过时 索引 帮助 
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法

java.lang
类 Long

java.lang.Object
  继承者 java.lang.Number
      继承者 java.lang.Long
所有已实现的接口：
Serializable, Comparable<Long> 
public final class Long
   
   
   
   
   
extends Number
   
   
   
   
   

   
   
   
   
   
implements Comparable<Long>

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

此外，该类提供了多个方法，可以将 long 转换为 String，将 String 转换为 long，除此之外，还提供了其他一些处理 long 时有用的常量和方法。

实现注意事项："bit twiddling" 方法（如 highestOneBit 和 numberOfTrailingZeros）的实现基于 Henry S. Warren 和 Jr. 撰写的《Hacker's Delight》(Addison Wesley, 2002) 一书中的资料。

从以下版本开始：
JDK1.0
另请参见：
序列化表格

字段摘要
static longMAX_VALUE
          保持 long 类型的最大值的常量，该值为 263-1。
static longMIN_VALUE
          保持 long 类型的最小值的常量，该值为 -263。
static intSIZE
          用来以二进制补码形式表示 long 值的位数。
static Class<Long>TYPE
          表示基本类型 long 的 Class 实例。
 
构造方法摘要
Long(long value)
          构造新分配的 Long 对象，表示指定的 long 参数。
Long(String s)
          构造新分配的 Long 对象，表示由 String 参数指示的 long 值。
 
方法摘要
static intbitCount(long i)
          返回指定 long 值的二进制补码表示形式中的 1 位的数量。
 bytebyteValue()
          以 byte 形式返回此 Long 的值。
 intcompareTo(Long anotherLong)
          在数字上比较两个 Long 对象。
static Longdecode(String nm)
          将 String 解码成 Long。
 doubledoubleValue()
          以 double 形式返回此 Long 的值。
 booleanequals(Object obj)
          将此对象与指定对象进行比较。
 floatfloatValue()
          以 float 形式返回此 Long 的值。
static LonggetLong(String nm)
          确定具有指定名称的系统属性的 long 值。
static LonggetLong(String nm, long val)
          使用指定名称确定系统属性的 long 值。
static LonggetLong(String nm, Long val)
          使用指定名称返回系统属性的 long 值。
 inthashCode()
          返回 Long 的哈希码。
static longhighestOneBit(long i)
          返回至多有一个 1 位的 long 值，在指定的 long 值中最高位（最左边）的 1 位的位置。
 intintValue()
          以 int 形式返回此 Long 的值。
 longlongValue()
          以 long 值的形式返回此 Long 的值。
static longlowestOneBit(long i)
          返回至多有一个 1 位的 long 值，在指定的 long 值中最低位（最右边）的 1 位的位置。
static intnumberOfLeadingZeros(long i)
          在指定 long 值的二进制补码表示形式中最高位（最左）的 1 位之前，返回零位的数量。
static intnumberOfTrailingZeros(long i)
          返回在指定 long 值的二进制补码表示形式中最低位（最右）的 1 位之后的零位的数量。
static longparseLong(String s)
          将 string 参数分析为有符号十进制 long。
static longparseLong(String s, int radix)
          将 string 参数分析为有符号的 long，基数由第二个参数指定。
static longreverse(long i)
          返回通过反转指定 long 值的二进制补码表示形式中位的顺序而获得的值。
static longreverseBytes(long i)
          返回通过反转指定 long 值的二进制补码表示形式中字节的顺序而获得的值。
static longrotateLeft(long i, int distance)
          返回根据指定的位数循环左移指定的 long 值的二进制补码表示形式而得到的值。
static longrotateRight(long i, int distance)
          返回根据指定的位数循环右移指定的 long 值的二进制补码表示形式而得到的值。
 shortshortValue()
          以 short 形式返回此 Long 的值。
static intsignum(long i)
          返回指定 long 值的符号函数。
static StringtoBinaryString(long i)
          以二进制无符号整数形式返回 long 参数的字符串表示形式。
static StringtoHexString(long i)
          以十六进制无符号整数形式返回 long 参数的字符串表示形式。
static StringtoOctalString(long i)
          以八进制无符号整数形式返回 long 参数的字符串表示形式。
 StringtoString()
          返回表示 Long 值的 String 对象。
static StringtoString(long i)
          返回表示指定 long 的 String 对象。
static StringtoString(long i, int radix)
          返回在使用第二个参数指定的基数时第一个参数的字符串表示形式。
static LongvalueOf(long l)
          返回表示指定 long 值的 Long 实例。
static LongvalueOf(String s)
          返回保持指定 String 的值的 Long 对象。
static LongvalueOf(String s, int radix)
          当使用第二个参数给出的基数进行分析时，返回保持从指定 String 中提取的值的 Long 对象。
 
从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

字段详细信息

MIN_VALUE

public static final long MIN_VALUE
保持 long 类型的最小值的常量，该值为 -263。

另请参见：
常量字段值

MAX_VALUE

public static final long MAX_VALUE
保持 long 类型的最大值的常量，该值为 263-1。

另请参见：
常量字段值

TYPE

public static final Class<Long> TYPE
表示基本类型 long 的 Class 实例。

从以下版本开始：
JDK1.1

SIZE

public static final int SIZE
用来以二进制补码形式表示 long 值的位数。

从以下版本开始：
1.5
另请参见：
常量字段值
构造方法详细信息

Long

public Long(long value)
构造新分配的 Long 对象，表示指定的 long 参数。

参数：
value - Long 对象表示的值。

Long

public Long(String s)
     throws NumberFormatException
构造新分配的 Long 对象，表示由 String 参数指示的 long 值。该字符串被转换为 long 值，其方式与 radix 参数为 10 的 parseLong 方法所使用的方式一致。

参数：
s - 要转换为 Long 的 String。
抛出：
NumberFormatException - 如果 String 不包含可分析的 long。
另请参见：
parseLong(java.lang.String, int)
方法详细信息

toString

public static String toString(long i,
                              int radix)
返回在使用第二个参数指定的基数时第一个参数的字符串表示形式。

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

如果第一个参数是负数，则结果的第一个元素是 ASCII 字符的减号 '-' ('\u002d')。如果第一个参数非负，则结果中不会出现符号字符。

结果的其余字符表示第一个参数的大小。如果大小为零，则用单个零字符 '0' 表示它 ('\u0030')；否则大小表示形式中的第一个字符将不是零字符。以下 ASCII 字符均被用作数字：

0123456789abcdefghijklmnopqrstuvwxyz
这些是从 '\u0030' 到 '\u0039' 和从 '\u0061' 到 '\u007a' 的字符。如果 radix 是 N，则这些字符的第一个 N 用作显示顺序中基数 N 的数字。因此，该数字的十六进制（基数 16）表示形式为 0123456789abcdef。如果需要使用大写字母，则可以在结果上调用 String.toUpperCase() 方法： 
Long.toString(n, 16).toUpperCase()

参数：
i - 要转换为字符串的 long。
radix - 将在字符串表示形式中使用的基数。
返回：
指定基数中参数的字符串表示形式。
另请参见：
Character.MAX_RADIX, Character.MIN_RADIX

toHexString

public static String toHexString(long i)
以十六进制无符号整数形式返回 long 参数的字符串表示形式。

如果参数为负，则无符号 long 值为该参数加上 264；否则，它等于该参数。此值将被转换为不带附加前导 0 的十六进制（基数 16）ASCII 数字字符串。如果无符号大小为零，则该数字由单个零字符 '0' 表示 ('\u0030')；否则，无符号大小表示形式中的第一个字符将不是零字符。下列字符都被用作十六进制数字：

0123456789abcdef
这些是从 '\u0030' 到 '\u0039' 和从 '\u0061' 到 '\u0066' 的字符。如果需要使用大写字母，则可以在结果上调用 String.toUpperCase() 方法： 
Long.toHexString(n).toUpperCase()

参数：
i - 要转换为字符串的 long。
返回：
十六进制（基数 16）参数表示的无符号 long 值的字符串表示形式。
从以下版本开始：
JDK 1.0.2

toOctalString

public static String toOctalString(long i)
以八进制无符号整数形式返回 long 参数的字符串表示形式。

如果参数为负，则无符号 long 值为该参数加上 264；否则，它等于该参数。此值将被转换为不带附加前导 0 的八进制（基数 8）ASCII 数字字符串。

如果无符号大小为零，则该数字用单个零字符 '0' ('\u0030') 表示，否则无符号大小表示形式中的第一个字符将不是零字符。以下字符都用作八进制数字：

 01234567
这些是从 '\u0030' 到 '\u0037' 的字符。

参数：
i - 要转换为字符串的 long。
返回：
八进制（基数 8）参数表示的无符号 long 值的字符串表示形式。
从以下版本开始：
JDK 1.0.2