java.lang
public
final
class
java.lang.Long
Summary
Constants
|
|
|
Value |
|
long |
MAX_VALUE |
Constant for the maximum long value, 263-1. |
9223372036854775807 |
0x7fffffffffffffff |
long |
MIN_VALUE |
Constant for the minimum long value, -231. |
-9223372036854775808 |
0x8000000000000000 |
int |
SIZE |
Constant for the number of bits to represent a long in
two's compliment form. |
64 |
0x00000040 |
Class<Long> |
TYPE |
The java.lang.Class that represents this class. |
|
|
Public Constructors
Public Methods
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
Details
Constants
public
static
final
long
MAX_VALUE
Constant for the maximum long
value, 263-1.
Constant Value:
9223372036854775807
(0x7fffffffffffffff)
public
static
final
long
MIN_VALUE
Constant for the minimum long
value, -231.
Constant Value:
-9223372036854775808
(0x8000000000000000)
public
static
final
int
SIZE
Constant for the number of bits to represent a long
in
two's compliment form.
Constant Value:
64
(0x00000040)
public
static
final
Class<Long>
TYPE
The java.lang.Class that represents this class.
Public Constructors
public
Long(long value)
Constructs a new instance of the receiver which represents the long
valued argument.
Parameters
value
| the long to store in the new instance.
|
public
Long(String string)
Constructs a new instance of this class given a string.
Parameters
string
| a string representation of an long quantity. |
Public Methods
public
static
int
bitCount(long lng)
Counts the number of 1 bits in the long
value passed; this
is sometimes referred to as a population count.
Parameters
lng
| The long value to process. |
public
byte
byteValue()
Returns the byte value which the receiver represents
Returns
- byte the value of the receiver.
public
int
compareTo(Long object)
Compares this Long
to the Long
passed. If
this instance's value is equal to the value of the instance passed, then
0 is returned. If this instance's value is less than the value of the
instance passed, then a negative value is returned. If this instance's
value is greater than the value of the instance passed, then a positive
value is returned.
Parameters
object
| The instance to compare to. |
public
static
Long
decode(String string)
Parses the string argument as if it was a long value and returns the
result. Throws NumberFormatException if the string does not represent a
long quantity. The string may be a hexadecimal ("0x..."), octal ("0..."),
or decimal ("...") representation of a long.
Parameters
string
| a string representation of an long quantity. |
Returns
- Long the value represented by the argument
public
double
doubleValue()
Returns the double value which the receiver represents
Returns
- double the value of the receiver.
public
boolean
equals(Object o)
Compares the argument to the receiver, and returns true if they represent
the
same object using a class specific comparison.
In this case, the argument must also be an Long, and the receiver and
argument must represent the same long value.
Parameters
o
| the object to compare with this object |
Returns
true
if the object is the same as this object
false
if it is different from this object
public
float
floatValue()
Returns the float value which the receiver represents
Returns
- float the value of the receiver.
public
static
Long
getLong(String string, Long defaultValue)
Returns an Long representing the long value of the property named by the
argument. If the property could not be found, or its value could not be
parsed as an long, answer the second argument.
Parameters
string
| The name of the desired long property. |
Returns
- Long An Long representing the value of the property.
public
static
Long
getLong(String string, long defaultValue)
Returns a Long representing the long value of the property named by the
argument. If the property could not be found, or its value could not be
parsed as a long, answer a Long representing the second argument.
Parameters
string
| The name of the desired long property. |
Returns
- Long An Long representing the value of the property.
public
static
Long
getLong(String string)
Returns a Long representing the long value of the property named by the
argument. If the property could not be found, or its value could not be
parsed as a long, answer null.
Parameters
string
| The name of the desired integer property. |
Returns
- Long A Long representing the value of the property.
public
int
hashCode()
Returns an integer hash code for the receiver. Any two objects which
answer
true
when passed to
equals
must
answer the same value for this method.
public
static
long
highestOneBit(long lng)
Determines the highest (leftmost) bit that is 1 and returns the value
that is the bit mask for that bit. This is sometimes referred to as the
Most Significant 1 Bit.
Parameters
lng
| The long to interrogate. |
Returns
- The bit mask indicating the highest 1 bit.
public
int
intValue()
Returns the int value which the receiver represents
Returns
- int the value of the receiver.
public
long
longValue()
Returns the long value which the receiver represents
Returns
- long the value of the receiver.
public
static
long
lowestOneBit(long lng)
Determines the lowest (rightmost) bit that is 1 and returns the value
that is the bit mask for that bit. This is sometimes referred to as the
Least Significant 1 Bit.
Parameters
lng
| The long to interrogate. |
Returns
- The bit mask indicating the lowest 1 bit.
public
static
int
numberOfLeadingZeros(long lng)
Determines the number of leading zeros in the long
passed
prior to the highest one bit.
Returns
- The number of leading zeros.
public
static
int
numberOfTrailingZeros(long lng)
Determines the number of trailing zeros in the long
passed
after the lowest one bit.
Returns
- The number of trailing zeros.
public
static
long
parseLong(String string, int radix)
Parses the string argument as if it was an long value and returns the
result. Throws NumberFormatException if the string does not represent an
long quantity. The second argument specifies the radix to use when
parsing the value.
Parameters
string
| a string representation of an long quantity. |
radix
| the base to use for conversion. |
Returns
- long the value represented by the argument
public
static
long
parseLong(String string)
Parses the string argument as if it was a long value and returns the
result. Throws NumberFormatException if the string does not represent a
long quantity.
Parameters
string
| a string representation of a long quantity. |
Returns
- long the value represented by the argument
public
static
long
reverse(long lng)
Reverses the bytes of a long
.
public
static
long
reverseBytes(long lng)
Reverses the bytes of a long
.
public
static
long
rotateLeft(long lng, int distance)
Rotates the bits of lng
to the left by the
distance
bits.
Parameters
lng
| The long value to rotate left. |
distance
| The number of bits to rotate. |
public
static
long
rotateRight(long lng, int distance)
Rotates the bits of lng
to the right by the
distance
bits.
Parameters
lng
| The long value to rotate right. |
distance
| The number of bits to rotate. |
public
short
shortValue()
Returns the short value which the receiver represents
Returns
- short the value of the receiver.
public
static
int
signum(long lng)
The signum
function for long
values. This
method returns -1 for negative values, 1 for positive values and 0 for
the value 0.
Returns
- -1 if negative, 1 if positive otherwise 0.
public
static
String
toBinaryString(long l)
Returns a string containing '0' and '1' characters which describe the
binary representation of the argument.
Parameters
l
| a long to get the binary representation of |
Returns
- String the binary representation of the argument
public
static
String
toHexString(long l)
Returns a string containing characters in the range 0..7, a..f which
describe the hexadecimal representation of the argument.
Parameters
l
| a long to get the hex representation of |
Returns
- String the hex representation of the argument
public
static
String
toOctalString(long l)
Returns a string containing characters in the range 0..7 which describe
the octal representation of the argument.
Parameters
l
| a long to get the octal representation of |
Returns
- String the octal representation of the argument
public
static
String
toString(long l, int radix)
Returns a string containing characters in the range 0..9, a..z (depending
on the radix) which describe the representation of the argument in that
radix.
Parameters
l
| a long to get the representation of |
radix
| the base to use for conversion. |
Returns
- String the representation of the argument
public
String
toString()
Returns a string containing a concise, human-readable description of the
receiver.
Returns
- a printable representation for the receiver.
public
static
String
toString(long l)
Returns a string containing characters in the range 0..9 which describe
the decimal representation of the argument.
Parameters
l
| a long to get the representation of |
Returns
- String the representation of the argument
public
static
Long
valueOf(String string, int radix)
Parses the string argument as if it was an long value and returns the
result. Throws NumberFormatException if the string does not represent an
long quantity. The second argument specifies the radix to use when
parsing the value.
Parameters
string
| a string representation of an long quantity. |
radix
| the base to use for conversion. |
Returns
- Long the value represented by the argument
public
static
Long
valueOf(String string)
Parses the string argument as if it was an long value and returns the
result. Throws NumberFormatException if the string does not represent an
long quantity.
Parameters
string
| a string representation of an long quantity. |
Returns
- Long the value represented by the argument
public
static
Long
valueOf(long lng)
Returns a Long
instance for the long
value
passed. This method is preferred over the constructor, as this method may
maintain a cache of instances.