所有类


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" 方法(如 highestOneBitnumberOfTrailingZeros)的实现基于 Henry S. Warren 和 Jr. 撰写的《Hacker's Delight》(Addison Wesley, 2002) 一书中的资料。

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

字段摘要
static long MAX_VALUE
          保持 long 类型的最大值的常量,该值为 263-1。
static long MIN_VALUE
          保持 long 类型的最小值的常量,该值为 -263
static int SIZE
          用来以二进制补码形式表示 long 值的位数。
static Class<Long> TYPE
          表示基本类型 longClass 实例。
 
构造方法摘要
Long(long value)
          构造新分配的 Long 对象,表示指定的 long 参数。
Long(String s)
          构造新分配的 Long 对象,表示由 String 参数指示的 long 值。
 
方法摘要
static int bitCount(long i)
          返回指定 long 值的二进制补码表示形式中的 1 位的数量。
 byte byteValue()
          以 byte 形式返回此 Long 的值。
 int compareTo(Long anotherLong)
          在数字上比较两个 Long 对象。
static Long decode(String nm)
          将 String 解码成 Long
 double doubleValue()
          以 double 形式返回此 Long 的值。
 boolean equals(Object obj)
          将此对象与指定对象进行比较。
 float floatValue()
          以 float 形式返回此 Long 的值。
static Long getLong(String nm)
          确定具有指定名称的系统属性的 long 值。
static Long getLong(String nm, long val)
          使用指定名称确定系统属性的 long 值。
static Long getLong(String nm, Long val)
          使用指定名称返回系统属性的 long 值。
 int hashCode()
          返回 Long 的哈希码。
static long highestOneBit(long i)
          返回至多有一个 1 位的 long 值,在指定的 long 值中最高位(最左边)的 1 位的位置。
 int intValue()
          以 int 形式返回此 Long 的值。
 long longValue()
          以 long 值的形式返回此 Long 的值。
static long lowestOneBit(long i)
          返回至多有一个 1 位的 long 值,在指定的 long 值中最低位(最右边)的 1 位的位置。
static int numberOfLeadingZeros(long i)
          在指定 long 值的二进制补码表示形式中最高位(最左)的 1 位之前,返回零位的数量。
static int numberOfTrailingZeros(long i)
          返回在指定 long 值的二进制补码表示形式中最低位(最右)的 1 位之后的零位的数量。
static long parseLong(String s)
          将 string 参数分析为有符号十进制 long
static long parseLong(String s, int radix)
          将 string 参数分析为有符号的 long,基数由第二个参数指定。
static long reverse(long i)
          返回通过反转指定 long 值的二进制补码表示形式中位的顺序而获得的值。
static long reverseBytes(long i)
          返回通过反转指定 long 值的二进制补码表示形式中字节的顺序而获得的值。
static long rotateLeft(long i, int distance)
          返回根据指定的位数循环左移指定的 long 值的二进制补码表示形式而得到的值。
static long rotateRight(long i, int distance)
          返回根据指定的位数循环右移指定的 long 值的二进制补码表示形式而得到的值。
 short shortValue()
          以 short 形式返回此 Long 的值。
static int signum(long i)
          返回指定 long 值的符号函数。
static String toBinaryString(long i)
          以二进制无符号整数形式返回 long 参数的字符串表示形式。
static String toHexString(long i)
          以十六进制无符号整数形式返回 long 参数的字符串表示形式。
static String toOctalString(long i)
          以八进制无符号整数形式返回 long 参数的字符串表示形式。
 String toString()
          返回表示 Long 值的 String 对象。
static String toString(long i)
          返回表示指定 longString 对象。
static String toString(long i, int radix)
          返回在使用第二个参数指定的基数时第一个参数的字符串表示形式。
static Long valueOf(long l)
          返回表示指定 long 值的 Long 实例。
static Long valueOf(String s)
          返回保持指定 String 的值的 Long 对象。
static Long valueOf(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
表示基本类型 longClass 实例。

从以下版本开始:
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 - 要转换为 LongString
抛出:
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' 的字符。如果 radixN,则这些字符的第一个 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

微信小程序

微信扫一扫体验

微信公众账号

微信扫一扫加关注

发表
评论
返回
顶部