|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.lang.Number
java.lang.Long
public final class Long
Instances of class Long
represent primitive
long
values.
Additionally, this class provides various helper functions and variables
related to longs.
Field Summary | |
---|---|
static long |
MAX_VALUE
The maximum value a long can represent is
9223372036854775807 (or 263 - 1). |
static long |
MIN_VALUE
The minimum value a long can represent is
-9223372036854775808L (or -263). |
static int |
SIZE
The number of bits needed to represent a long . |
static Class<Long> |
TYPE
The primitive type long is represented by this
Class object. |
Constructor Summary | |
---|---|
Long(long value)
Create a Long object representing the value of the
long argument. |
|
Long(String s)
Create a Long object representing the value of the
argument after conversion to a long . |
Method Summary | |
---|---|
static int |
bitCount(long x)
Return the number of bits set in x. |
byte |
byteValue()
Return the value of this Long as a byte . |
int |
compareTo(Long l)
Compare two Longs numerically by comparing their long
values. |
static Long |
decode(String str)
Convert the specified String into a Long . |
double |
doubleValue()
Return the value of this Long as a double . |
boolean |
equals(Object obj)
Returns true if obj is an instance of
Long and represents the same long value. |
float |
floatValue()
Return the value of this Long as a float . |
static Long |
getLong(String nm)
Get the specified system property as a Long . |
static Long |
getLong(String nm,
long val)
Get the specified system property as a Long , or use a
default long value if the property is not found or is not
decodable. |
static Long |
getLong(String nm,
Long def)
Get the specified system property as a Long , or use a
default Long value if the property is not found or is
not decodable. |
int |
hashCode()
Return a hashcode representing this Object. |
static long |
highestOneBit(long value)
Find the highest set bit in value, and return a new value with only that bit set. |
int |
intValue()
Return the value of this Long as an int . |
long |
longValue()
Return the value of this Long . |
static long |
lowestOneBit(long value)
Find the lowest set bit in value, and return a new value with only that bit set. |
static int |
numberOfLeadingZeros(long value)
Return the number of leading zeros in value. |
static int |
numberOfTrailingZeros(long value)
Find the number of trailing zeros in value. |
static long |
parseLong(String s)
Converts the specified String into a long . |
static long |
parseLong(String str,
int radix)
Converts the specified String into an int
using the specified radix (base). |
static long |
reverse(long val)
Reverse the bits in val. |
static long |
reverseBytes(long val)
Reverse the bytes in val. |
static long |
rotateLeft(long x,
int distance)
Rotate x to the left by distance bits. |
static long |
rotateRight(long x,
int distance)
Rotate x to the right by distance bits. |
short |
shortValue()
Return the value of this Long as a short . |
static int |
signum(long x)
Return 1 if x is positive, -1 if it is negative, and 0 if it is zero. |
static String |
toBinaryString(long l)
Converts the long to a String assuming it is
unsigned in base 2. |
static String |
toHexString(long l)
Converts the long to a String assuming it is
unsigned in base 16. |
static String |
toOctalString(long l)
Converts the long to a String assuming it is
unsigned in base 8. |
String |
toString()
Converts the Long value to a String and
assumes a radix of 10. |
static String |
toString(long num)
Converts the long to a String and assumes
a radix of 10. |
static String |
toString(long num,
int radix)
Converts the long to a String using
the specified radix (base). |
static Long |
valueOf(long val)
Returns a Long object wrapping the value. |
static Long |
valueOf(String s)
Creates a new Long object using the String ,
assuming a radix of 10. |
static Long |
valueOf(String s,
int radix)
Creates a new Long object using the String
and specified radix (base). |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final long MIN_VALUE
long
can represent is
-9223372036854775808L (or -263).
public static final long MAX_VALUE
long
can represent is
9223372036854775807 (or 263 - 1).
public static final Class<Long> TYPE
long
is represented by this
Class
object.
public static final int SIZE
long
.
Constructor Detail |
---|
public Long(long value)
Long
object representing the value of the
long
argument.
value
- the value to usepublic Long(String s)
Long
object representing the value of the
argument after conversion to a long
.
s
- the string to convert
NumberFormatException
- if the String does not contain a longvalueOf(String)
Method Detail |
---|
public static String toString(long num, int radix)
long
to a String
using
the specified radix (base). If the radix exceeds
Character.MIN_RADIX
or Character.MAX_RADIX
, 10
is used instead. If the result is negative, the leading character is
'-' ('\\u002D'). The remaining characters come from
Character.forDigit(digit, radix)
('0'-'9','a'-'z').
num
- the long
to convert to String
radix
- the radix (base) to use in the conversion
String
representation of the argumentpublic static String toHexString(long l)
long
to a String
assuming it is
unsigned in base 16.
l
- the long
to convert to String
String
representation of the argumentpublic static String toOctalString(long l)
long
to a String
assuming it is
unsigned in base 8.
l
- the long
to convert to String
String
representation of the argumentpublic static String toBinaryString(long l)
long
to a String
assuming it is
unsigned in base 2.
l
- the long
to convert to String
String
representation of the argumentpublic static String toString(long num)
long
to a String
and assumes
a radix of 10.
num
- the long
to convert to String
String
representation of the argumenttoString(long, int)
public static long parseLong(String str, int radix)
String
into an int
using the specified radix (base). The string must not be null
or empty. It may begin with an optional '-', which will negate the answer,
provided that there are also valid digits. Each digit is parsed as if by
Character.digit(d, radix)
, and must be in the range
0
to radix - 1
. Finally, the result must be
within MIN_VALUE
to MAX_VALUE
, inclusive.
Unlike Double.parseDouble, you may not have a leading '+'; and 'l' or
'L' as the last character is only valid in radices 22 or greater, where
it is a digit and not a type indicator.
str
- the String
to convertradix
- the radix (base) to use in the conversion
String
argument converted to long
NumberFormatException
- if s
cannot be parsed as a
long
public static long parseLong(String s)
String
into a long
.
This function assumes a radix of 10.
s
- the String
to convert
int
value of s
NumberFormatException
- if s
cannot be parsed as a
long
parseLong(String, int)
public static Long valueOf(String s, int radix)
Long
object using the String
and specified radix (base).
s
- the String
to convertradix
- the radix (base) to convert with
Long
NumberFormatException
- if s
cannot be parsed as a
long
parseLong(String, int)
public static Long valueOf(String s)
Long
object using the String
,
assuming a radix of 10.
s
- the String
to convert
Long
NumberFormatException
- if s
cannot be parsed as a
long
Long(String)
,
parseLong(String)
public static Long valueOf(long val)
Long
object wrapping the value.
val
- the value to wrap
Long
public static Long decode(String str)
String
into a Long
.
The String
may represent decimal, hexadecimal, or
octal numbers.
The extended BNF grammar is as follows:
DecodableString: ( [Finally, the value must be in the range-
] DecimalNumber ) | ( [-
] (0x
|0X
|#
) HexDigit { HexDigit } ) | ( [-
]0
{ OctalDigit } ) DecimalNumber: DecimalDigit except '0' { DecimalDigit } DecimalDigit: Character.digit(d, 10) has value 0 to 9 OctalDigit: Character.digit(d, 8) has value 0 to 7 DecimalDigit: Character.digit(d, 16) has value 0 to 15
MIN_VALUE
to
MAX_VALUE
, or an exception is thrown. Note that you cannot
use a trailing 'l' or 'L', unlike in Java source code.
str
- the String
to interpret
Long
NumberFormatException
- if s
cannot be parsed as a
long
NullPointerException
- if s
is nullpublic byte byteValue()
Long
as a byte
.
byteValue
in class Number
public short shortValue()
Long
as a short
.
shortValue
in class Number
public int intValue()
Long
as an int
.
intValue
in class Number
public long longValue()
Long
.
longValue
in class Number
public float floatValue()
Long
as a float
.
floatValue
in class Number
public double doubleValue()
Long
as a double
.
doubleValue
in class Number
public String toString()
Long
value to a String
and
assumes a radix of 10.
toString
in class Object
String
representationObject.getClass()
,
Object.hashCode()
,
Class.getName()
,
Integer.toHexString(int)
public int hashCode()
Long
's hash
code is calculated by (int) (value ^ (value >> 32))
.
hashCode
in class Object
Object.equals(Object)
,
System.identityHashCode(Object)
public boolean equals(Object obj)
true
if obj
is an instance of
Long
and represents the same long value.
equals
in class Object
obj
- the object to compare
Object.hashCode()
public static Long getLong(String nm)
Long
. The
decode()
method will be used to interpret the value of
the property.
nm
- the name of the system property
Long
, or null if the
property is not found or cannot be decoded
SecurityException
- if accessing the system property is forbiddenSystem.getProperty(String)
,
decode(String)
public static Long getLong(String nm, long val)
Long
, or use a
default long
value if the property is not found or is not
decodable. The decode()
method will be used to interpret
the value of the property.
nm
- the name of the system propertyval
- the default value
SecurityException
- if accessing the system property is forbiddenSystem.getProperty(String)
,
decode(String)
public static Long getLong(String nm, Long def)
Long
, or use a
default Long
value if the property is not found or is
not decodable. The decode()
method will be used to
interpret the value of the property.
nm
- the name of the system propertydef
- the default value
SecurityException
- if accessing the system property is forbiddenSystem.getProperty(String)
,
decode(String)
public int compareTo(Long l)
long
values. The result is positive if the first is greater, negative if the
second is greater, and 0 if the two are equal.
compareTo
in interface Comparable<Long>
l
- the Long to compare
public static int bitCount(long x)
x
- value to examinepublic static long rotateLeft(long x, int distance)
x
- the value to rotatedistance
- the number of bits by which to rotatepublic static long rotateRight(long x, int distance)
x
- the value to rotatedistance
- the number of bits by which to rotatepublic static long highestOneBit(long value)
value
- the value to examinepublic static int numberOfLeadingZeros(long value)
value
- the value to examinepublic static long lowestOneBit(long value)
value
- the value to examinepublic static int numberOfTrailingZeros(long value)
value
- the value to examinepublic static int signum(long x)
x
- the value to examinepublic static long reverseBytes(long val)
public static long reverse(long val)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |