java.lang.Object | ||
↳ | java.lang.Number | |
↳ | java.lang.Long |
The wrapper for the primitive type long
.
Implementation note: The "bit twiddling" methods in this class use techniques described in Henry S. Warren, Jr.'s Hacker's Delight, (Addison Wesley, 2002) and Sean Anderson's Bit Twiddling Hacks.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
long | MAX_VALUE | Constant for the maximum long value, 263-1. |
|||||||||
long | MIN_VALUE | Constant for the minimum long value, -263. |
|||||||||
int | SIZE | Constant for the number of bits needed to represent a long in
two's complement form. |
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
TYPE | The Class object that represents the primitive type long . |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructs a new
Long with the specified primitive long value. | |||||||||||
Constructs a new
Long from the specified string. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Counts the number of 1 bits in the specified long value; this is also
referred to as population count.
| |||||||||||
Returns this object's value as a byte.
| |||||||||||
Compares this object to the specified long object to determine their
relative order.
| |||||||||||
Parses the specified string and returns a
Long instance if the
string can be decoded into a long value. | |||||||||||
Returns this object's value as a double.
| |||||||||||
Compares this instance with the specified object and indicates if they
are equal.
| |||||||||||
Returns this object's value as a float.
| |||||||||||
Returns the
Long value of the system property identified by
string . | |||||||||||
Returns the
Long value of the system property identified by
string . | |||||||||||
Returns the
Long value of the system property identified by
string . | |||||||||||
Returns an integer hash code for this object.
| |||||||||||
Determines the highest (leftmost) bit of the specified long value that is
1 and returns the bit mask value for that bit.
| |||||||||||
Returns this object's value as an int.
| |||||||||||
Gets the primitive value of this long.
| |||||||||||
Determines the lowest (rightmost) bit of the specified long value that is
1 and returns the bit mask value for that bit.
| |||||||||||
Determines the number of leading zeros in the specified long value prior
to the
highest one bit . | |||||||||||
Determines the number of trailing zeros in the specified long value after
the
lowest one bit . | |||||||||||
Parses the specified string as a signed long value using the specified
radix.
| |||||||||||
Parses the specified string as a signed decimal long value.
| |||||||||||
Reverses the order of the bits of the specified long value.
| |||||||||||
Reverses the order of the bytes of the specified long value.
| |||||||||||
Rotates the bits of the specified long value to the left by the specified
number of bits.
| |||||||||||
Rotates the bits of the specified long value to the right by the
specified number of bits.
| |||||||||||
Returns this object's value as a short.
| |||||||||||
Returns the value of the
signum function for the specified long
value. | |||||||||||
Converts the specified long value into its binary string representation.
| |||||||||||
Converts the specified long value into its hexadecimal string
representation.
| |||||||||||
Converts the specified long value into its octal string representation.
| |||||||||||
Returns a string containing a concise, human-readable description of this
object.
| |||||||||||
Converts the specified long value into its decimal string representation.
| |||||||||||
Converts the specified signed long value into a string representation based on
the specified radix.
| |||||||||||
Parses the specified string as a signed long value using the specified
radix.
| |||||||||||
Returns a
Long instance for the specified long value. | |||||||||||
Parses the specified string as a signed decimal long value.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Number
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
java.lang.Comparable
|
Constant for the maximum long
value, 263-1.
Constant for the minimum long
value, -263.
Constant for the number of bits needed to represent a long
in
two's complement form.
The Class
object that represents the primitive type long
.
Constructs a new Long
with the specified primitive long value.
value | the primitive long value to store in the new instance. |
---|
Constructs a new Long
from the specified string.
string | the string representation of a long value. |
---|
NumberFormatException | if string cannot be parsed as a long value. |
---|
Counts the number of 1 bits in the specified long value; this is also referred to as population count.
v | the long to examine. |
---|
v
.Returns this object's value as a byte. Might involve rounding and/or truncating the value, so it fits into a byte.
Compares this object to the specified long object to determine their relative order.
object | the long object to compare this object to. |
---|
object
; 0 if the value of this long and the value of
object
are equal; a positive value if the value of this
long is greater than the value of object
.Parses the specified string and returns a Long
instance if the
string can be decoded into a long value. The string may be an optional
minus sign "-" followed by a hexadecimal ("0x..." or "#..."), octal
("0..."), or decimal ("...") representation of a long.
string | a string representation of a long value. |
---|
Long
containing the value represented by string
.NumberFormatException | if string cannot be parsed as a long value.
|
---|
Returns this object's value as a double. Might involve rounding.
Compares this instance with the specified object and indicates if they
are equal. In order to be equal, o
must be an instance of
Long
and have the same long value as this object.
o | the object to compare this long with. |
---|
true
if the specified object is equal to this
Long
; false
otherwise.
Returns this object's value as a float. Might involve rounding.
Returns the Long
value of the system property identified by
string
. Returns the specified default value if string
is
null
or empty, if the property can not be found or if its value
can not be parsed as a long.
string | the name of the requested system property. |
---|---|
defaultValue | the default value that is returned if there is no long system property with the requested name. |
Long
or the default
value.
Returns the Long
value of the system property identified by
string
. Returns the specified default value if string
is
null
or empty, if the property can not be found or if its value
can not be parsed as a long.
string | the name of the requested system property. |
---|---|
defaultValue | the default value that is returned if there is no long system property with the requested name. |
Long
or the default
value.
Returns the Long
value of the system property identified by
string
. Returns null
if string
is null
or empty, if the property can not be found or if its value can not be
parsed as a long.
string | the name of the requested system property. |
---|
Long
or null
.
Returns an integer hash code for this object. By contract, any two
objects for which equals(Object)
returns true
must return
the same hash code value. This means that subclasses of Object
usually override both methods or neither method.
Note that hash values must not change over time unless information used in equals comparisons also changes.
See Writing a correct
hashCode
method
if you intend implementing your own hashCode
method.
Determines the highest (leftmost) bit of the specified long value that is 1 and returns the bit mask value for that bit. This is also referred to as the Most Significant 1 Bit. Returns zero if the specified long is zero.
v | the long to examine. |
---|
v
.Returns this object's value as an int. Might involve rounding and/or truncating the value, so it fits into an int.
Gets the primitive value of this long.
Determines the lowest (rightmost) bit of the specified long value that is 1 and returns the bit mask value for that bit. This is also referred to as the Least Significant 1 Bit. Returns zero if the specified long is zero.
v | the long to examine. |
---|
v
.Determines the number of leading zeros in the specified long value prior
to the highest one bit
.
v | the long to examine. |
---|
v
.Determines the number of trailing zeros in the specified long value after
the lowest one bit
.
v | the long to examine. |
---|
v
.Parses the specified string as a signed long value using the specified radix. The ASCII character - ('-') is recognized as the minus sign.
string | the string representation of a long value. |
---|---|
radix | the radix to use when parsing. |
string
using
radix
.NumberFormatException | if string cannot be parsed as a long value, or
radix < Character.MIN_RADIX ||
radix > Character.MAX_RADIX .
|
---|
Parses the specified string as a signed decimal long value. The ASCII character - ('-') is recognized as the minus sign.
string | the string representation of a long value. |
---|
string
.NumberFormatException | if string cannot be parsed as a long value.
|
---|
Reverses the order of the bits of the specified long value.
v | the long value for which to reverse the bit order. |
---|
Reverses the order of the bytes of the specified long value.
v | the long value for which to reverse the byte order. |
---|
Rotates the bits of the specified long value to the left by the specified number of bits.
v | the long value to rotate left. |
---|---|
distance | the number of bits to rotate. |
Rotates the bits of the specified long value to the right by the specified number of bits.
v | the long value to rotate right. |
---|---|
distance | the number of bits to rotate. |
Returns this object's value as a short. Might involve rounding and/or truncating the value, so it fits into a short.
Returns the value of the signum
function for the specified long
value.
v | the long value to check. |
---|
v
is negative, 1 if v
is positive, 0 if
v
is zero.Converts the specified long value into its binary string representation. The returned string is a concatenation of '0' and '1' characters.
v | the long value to convert. |
---|
v
.
Converts the specified long value into its hexadecimal string representation. The returned string is a concatenation of characters from '0' to '9' and 'a' to 'f'.
v | the long value to convert. |
---|
l
.
Converts the specified long value into its octal string representation. The returned string is a concatenation of characters from '0' to '7'.
v | the long value to convert. |
---|
l
.
Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:
getClass().getName() + '@' + Integer.toHexString(hashCode())
See Writing a useful
toString
method
if you intend implementing your own toString
method.
Converts the specified long value into its decimal string representation. The returned string is a concatenation of a minus sign if the number is negative and characters from '0' to '9'.
n | the long to convert. |
---|
l
.
Converts the specified signed long value into a string representation based on
the specified radix. The returned string is a concatenation of a minus
sign if the number is negative and characters from '0' to '9' and 'a' to
'z', depending on the radix. If radix
is not in the interval
defined by Character.MIN_RADIX
and Character.MAX_RADIX
then 10 is used as the base for the conversion.
This method treats its argument as signed. If you want to convert an
unsigned value to one of the common non-decimal bases, you may find
toBinaryString(long)
, #toHexString
, or toOctalString(long)
more convenient.
v | the signed long to convert. |
---|---|
radix | the base to use for the conversion. |
v
.
Parses the specified string as a signed long value using the specified radix.
string | the string representation of a long value. |
---|---|
radix | the radix to use when parsing. |
Long
instance containing the long value represented by
string
using radix
.NumberFormatException | if string cannot be parsed as a long value, or
radix < Character.MIN_RADIX ||
radix > Character.MAX_RADIX . |
---|
Returns a Long
instance for the specified long value.
If it is not necessary to get a new Long
instance, it is
recommended to use this method instead of the constructor, since it
maintains a cache of instances which may result in better performance.
v | the long value to store in the instance. |
---|
Long
instance containing v
.Parses the specified string as a signed decimal long value.
string | the string representation of a long value. |
---|
Long
instance containing the long value represented by
string
.NumberFormatException | if string cannot be parsed as a long value. |
---|