java.lang.Object | |
↳ | java.lang.Integer |
The Integer class wraps a value of the primitive type int
in an
object. An object of type Integer
contains a single field whose
type is int
.
In addition, this class provides several methods for converting an
int
to a String
and a String
to an
int
, as well as other constants and methods useful when dealing
with an int
.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | MAX_VALUE | The largest value of type int . |
|||||||||
int | MIN_VALUE | The smallest value of type int . |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Integer(int value)
Constructs a newly allocated
Integer object that represents the
primitive int argument. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
byte |
byteValue()
Returns the value of this Integer as a byte.
| ||||||||||
boolean |
equals(Object obj)
Compares this object to the specified object.
| ||||||||||
int |
hashCode()
Returns a hashcode for this Integer.
| ||||||||||
int |
intValue()
Returns the value of this Integer as an int.
| ||||||||||
long |
longValue()
Returns the value of this Integer as a long.
| ||||||||||
static int |
parseInt(String s)
Parses the string argument as a signed decimal integer.
| ||||||||||
static int |
parseInt(String s, int radix)
Parses the string argument as a signed integer in the radix specified by the
second argument.
| ||||||||||
short |
shortValue()
Returns the value of this Integer as a short.
| ||||||||||
static String |
toBinaryString(int i)
Creates a string representation of the integer argument as an unsigned
integer in base 2.
| ||||||||||
static String |
toHexString(int i)
Creates a string representation of the integer argument as an unsigned
integer in base 16.
| ||||||||||
static String |
toOctalString(int i)
Creates a string representation of the integer argument as an unsigned
integer in base 8.
| ||||||||||
String |
toString()
Returns a String object representing this Integer's value.
| ||||||||||
static String |
toString(int i)
Returns a new String object representing the specified integer.
| ||||||||||
static String |
toString(int i, int radix)
Creates a string representation of the first argument in the radix specified
by the second argument.
| ||||||||||
static Integer |
valueOf(String s)
Returns a new Integer object initialized to the value of the specified
String.
| ||||||||||
static Integer |
valueOf(String s, int radix)
Returns a new Integer object initialized to the value of the specified
String.
| ||||||||||
static Integer |
valueOf(int i)
Returns an Integer instance representing the specified int value.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() |
The largest value of type int
. The constant value of this field
is 2147483647.
The smallest value of type int
. The constant value of this field
is -2147483648.
Constructs a newly allocated Integer
object that represents the
primitive int
argument.
value | the value to be represented by the Integer .
|
---|
Returns the value of this Integer as a byte.
Compares this object to the specified object. The result is true
if and only if the argument is not null
and is an
Integer
object that contains the same int
value as
this object.
obj | the object to compare with. |
---|
true
if the objects are the same; false
otherwise.
Returns a hashcode for this Integer.
Returns the value of this Integer as an int.
int
value represented by this object.
Returns the value of this Integer as a long.
int
value represented by this object that is
converted to type long
and the result of the conversion
is returned.
Parses the string argument as a signed decimal integer. The characters in the
string must all be decimal digits, except that the first character may be an
ASCII minus sign '-'
( '\u002d') to indicate a
negative value. The resulting integer value is returned, exactly as if the
argument and the radix 10 were given as arguments to the
parseInt(java.lang.String, int)
method.
s | a string. |
---|
NumberFormatException | if the string does not contain a parsable integer. |
---|
Parses the string argument as a signed integer in the radix specified by the
second argument. The characters in the string must all be digits of the
specified radix (as determined by whether
digit(char, int)
returns a nonnegative value),
except that the first character may be an ASCII minus sign '-'
('\u002d'
) to indicate a negative value. The resulting
integer value is returned.
An exception of type NumberFormatException is thrown if any of the following situations occurs:
MIN_RADIX
or
larger than MAX_RADIX
.
Examples:
parseInt("0", 10) returns 0 parseInt("473", 10) returns 473 parseInt("-0", 10) returns 0 parseInt("-FF", 16) returns -255 parseInt("1100110", 2) returns 102 parseInt("2147483647", 10) returns 2147483647 parseInt("-2147483648", 10) returns -2147483648 parseInt("2147483648", 10) throws a NumberFormatException parseInt("99", 8) throws a NumberFormatException parseInt("Kona", 10) throws a NumberFormatException parseInt("Kona", 27) returns 411787
s | the String containing the integer. |
---|---|
radix | the radix to be used. |
NumberFormatException | if the string does not contain a parsable integer. |
---|
Returns the value of this Integer as a short.
Creates a string representation of the integer argument as an unsigned integer in base 2.
The unsigned integer value is the argument plus 232if the argument
is negative; otherwise it is equal to the argument. This value is converted
to a string of ASCII digits in binary (base 2) with no extra leading
0
s. If the unsigned magnitude is zero, it is represented by a
single zero character '0' ( '\u0030'); otherwise, the
first character of the representation of the unsigned magnitude will not be
the zero character. The characters '0' ('\u0030') and
'1' ( '\u0031') are used as binary digits.
i | an integer. |
---|
Creates a string representation of the integer argument as an unsigned integer in base 16.
The unsigned integer value is the argument plus 232 if the
argument is negative; otherwise, it is equal to the argument. This value is
converted to a string of ASCII digits in hexadecimal (base 16) with no
extra leading 0
s. If the unsigned magnitude is zero, it is
represented by a single zero character '0' ( '\u0030');
otherwise, the first character of the representation of the unsigned
magnitude will not be the zero character. The following characters are used
as hexadecimal digits:
These are the characters '\u0030' through '\u0039' and 'u\0039' through '\u0066'.0123456789abcdef
i | an integer. |
---|
Creates a string representation of the integer argument as an unsigned integer in base 8.
The unsigned integer value is the argument plus 232 if the
argument is negative; otherwise, it is equal to the argument. This value is
converted to a string of ASCII digits in octal (base 8) with no extra
leading 0
s.
If the unsigned magnitude is zero, it is represented by a single zero character '0' ('\u0030'); otherwise, the first character of the representation of the unsigned magnitude will not be the zero character. The octal digits are:
These are the characters '\u0030' through '\u0037'.01234567
i | an integer |
---|
Returns a String object representing this Integer's value. The value is
converted to signed decimal representation and returned as a string, exactly
as if the integer value were given as an argument to the
toString(int)
method.
Returns a new String object representing the specified integer. The argument
is converted to signed decimal representation and returned as a string,
exactly as if the argument and radix 10 were given as arguments to
the toString(int, int)
method.
i | an integer to be converted. |
---|
Creates a string representation of the first argument in the radix specified by the second argument.
If the radix is smaller than Character.MIN_RADIX
or larger than
Character.MAX_RADIX
, then the radix 10
is used
instead.
If the first argument is negative, the first element of the result is the
ASCII minus character '-'
('\u002d'). If the first
argument is not negative, no sign character appears in the result.
The remaining characters of the result represent the magnitude of the first argument. If the magnitude is zero, it is represented by a single zero character '0' ('\u0030'); otherwise, the first character of the representation of the magnitude will not be the zero character. The following ASCII characters are used as digits:
These are '\u0030' through '\u0039' and '\u0061' through '\u007a'. If the radix is N, then the first N of these characters are used as radix-N digits in the order shown. Thus, the digits for hexadecimal (radix 16) are0123456789abcdefghijklmnopqrstuvwxyz
0123456789abcdef.
i | an integer. |
---|---|
radix | the radix. |
Returns a new Integer object initialized to the value of the specified
String. The argument is interpreted as representing a signed decimal integer,
exactly as if the argument were given to the
parseInt(java.lang.String)
method. The result is an Integer
object that represents the integer value specified by the string.
In other words, this method returns an Integer object equal to the value of:
new Integer(Integer.parseInt(s))
s | the string to be parsed. |
---|
Integer
initialized to the value
represented by the string argument.NumberFormatException | if the string cannot be parsed as an integer. |
---|
Returns a new Integer object initialized to the value of the specified
String. The first argument is interpreted as representing a signed integer in
the radix specified by the second argument, exactly as if the arguments were
given to the parseInt(java.lang.String, int)
method. The result is
an Integer
object that represents the integer value specified by
the string.
In other words, this method returns an Integer
object equal to
the value of:
new Integer(Integer.parseInt(s, radix))
s | the string to be parsed. |
---|---|
radix | the radix of the integer represented by string s |
Integer
initialized to the value
represented by the string argument in the specified radix.NumberFormatException | if the String cannot be parsed as an int .
|
---|
Returns an Integer instance representing the specified int value. If a new Integer instance is not required, this method should generally be used in preference to the constructor Integer(int), as this method is likely to yield significantly better space and time performance by caching frequently requested values.
i | an int value. |
---|