public final class Long extends Number
Long represent primitive
long values.
Additionally, this class provides various helper functions and variables
related to longs.| Modifier and Type | Field and Description |
|---|---|
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 Class |
TYPE
The primitive type
long is represented by this
Class object. |
| Constructor and Description |
|---|
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. |
| Modifier and Type | Method and Description |
|---|---|
byte |
byteValue()
Return the value of this
Long as a byte. |
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.
|
int |
intValue()
Return the value of this
Long as an int. |
long |
longValue()
Return the value of this
Long. |
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). |
short |
shortValue()
Return the value of this
Long as a short. |
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(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). |
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 TYPE
long is represented by this
Class object.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 convertNumberFormatException - if the String does not contain a longvalueOf(String)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 Stringradix - the radix (base) to use in the conversionString 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 StringString 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 StringString 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 StringString 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 StringString 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.s - the String to convertradix - the radix (base) to use in the conversionString argument converted to longNumberFormatException - if s cannot be parsed as a
longpublic static long parseLong(String s)
String into a long.
This function assumes a radix of 10.s - the String to convertint value of sNumberFormatException - if s cannot be parsed as a
longparseLong(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 withLongNumberFormatException - if s cannot be parsed as a
longparseLong(String, int)public static Long valueOf(String s)
Long object using the String,
assuming a radix of 10.s - the String to convertLongNumberFormatException - if s cannot be parsed as a
longLong(String),
parseLong(String)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:
( [ - ] 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
Finally, the value must be in the range 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.s - the String to interpretLongNumberFormatException - if s cannot be parsed as a
longNullPointerException - if s is nullpublic byte byteValue()
Long as a byte.public short shortValue()
Long as a short.shortValue in class Numberpublic int intValue()
Long as an int.public long longValue()
Long.public float floatValue()
Long as a float.floatValue in class Numberpublic double doubleValue()
Long as a double.doubleValue in class Numberpublic String toString()
Long value to a String and
assumes a radix of 10.public int hashCode()
Long's hash
code is calculated by (int) (value ^ (value >> 32)).public boolean equals(Object obj)
true if obj is an instance of
Long and represents the same long value.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 propertyLong, or null if the
property is not found or cannot be decodedSecurityException - 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 valueSecurityException - 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 propertyval - the default valueSecurityException - if accessing the system property is forbiddenSystem.getProperty(String),
decode(String)