Class java.lang.Integer
All Packages Class Hierarchy This Package Previous Next Index
Class java.lang.Integer
Object

+Number

+java.lang.Integer
 public final class Integer
 extends Number
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
.
 Version:
 1.43, 07/07/98
 Author:
 Lee Boynton, Arthur van Hoff
 Since:
 JDK1.0

MAX_VALUE
 The largest value of type
int
.

MIN_VALUE
 The smallest value of type
int
.

TYPE
 The Class object representing the primitive type int.

java.lang.Integer(int)
 Constructs a newly allocated
Integer
object that
represents the primitive int
argument.

java.lang.Integer(String)
 Constructs a newly allocated
Integer
object that
represents the value represented by the string.

byteValue()
 Returns the value of this Integer as a byte.

decode(String)
 Decodes a string into an Integer.

doubleValue()
 Returns the value of this Integer as a double.

equals(Object)
 Compares this object to the specified object.

floatValue()
 Returns the value of this Integer as a float.

getInteger(String)
 Determines the integer value of the system property with the
specified name.

getInteger(String, int)
 Determines the integer value of the system property with the
specified name.

getInteger(String, Integer)
 Determines the integer value of the system property with the
specified name.

hashCode()
 Returns a hashcode for this Integer.

intValue()
 Returns the value of this Integer as an int.

longValue()
 Returns the value of this Integer as a long.

parseInt(String, int)
 Parses the string argument as a signed integer in the radix
specified by the second argument.

parseInt(String)
 Parses the string argument as a signed decimal integer.

shortValue()
 Returns the value of this Integer as a short.

toBinaryString(int)
 Creates a string representation of the integer argument as an
unsigned integer in base 2.

toHexString(int)
 Creates a string representation of the integer argument as an
unsigned integer in base 16.

toOctalString(int)
 Creates a string representation of the integer argument as an
unsigned integer in base 8.

toString(int, int)
 Creates a string representation of the first argument in the
radix specified by the second argument.

toString(int)
 Returns a new String object representing the specified integer.

toString()
 Returns a String object representing this Integer's value.

valueOf(String, int)
 Returns a new Integer object initialized to the value of the
specified String.

valueOf(String)
 Returns a new Integer object initialized to the value of the
specified String.
MAX_VALUE
public static final int MAX_VALUE
 The largest value of type
int
.
 Since:
JDK1.0
MIN_VALUE
public static final int MIN_VALUE
 The smallest value of type
int
.
 Since:
JDK1.0
TYPE
public static final java.lang.Class TYPE
 The Class object representing the primitive type int.
 Since:
JDK1.1
Integer
public Integer(int value)
 Constructs a newly allocated
Integer
object that
represents the primitive int
argument.
 Parameters:
 value  the value to be represented by the
Integer
.
 Since:
 JDK1.0
Integer
public Integer(String s) throws NumberFormatException
 Constructs a newly allocated
Integer
object that
represents the value represented by the string. The string is
converted to an int value as if by the valueOf
method.
 Parameters:
 s  the
String
to be converted to an
Integer
.
 Throws: NumberFormatException
 if the
String
does not
contain a parsable integer.
 Since:
 JDK1.0
 See Also:
 valueOf(java.lang.String, int)
byteValue
public byte byteValue()
 Returns the value of this Integer as a byte.
 Overrides:
 byteValue in class Number
 Since:
 JDK1.1
decode
public static java.lang.Integer decode(String nm) throws NumberFormatException
 Decodes a string into an Integer. Deals with decimal, hexadecimal,
and octal numbers.
 Parameters:
 nm  the string to decode
 Since:
 JDK1.1
doubleValue
public double doubleValue()
 Returns the value of this Integer as a double.
 Returns:
 the
int
value represented by this object is
converted to type double
and the result of the
conversion is returned.
 Overrides:
 doubleValue in class Number
 Since:
 JDK1.0
equals
public boolean equals(Object obj)
 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.
 Parameters:
 obj  the object to compare with.
 Returns:

true
if the objects are the same;
false
otherwise.
 Overrides:
 equals in class Object
 Since:
 JDK1.0
floatValue
public float floatValue()
 Returns the value of this Integer as a float.
 Returns:
 the
int
value represented by this object is
converted to type float
and the result of the
conversion is returned.
 Overrides:
 floatValue in class Number
 Since:
 JDK1.0
getInteger
public static java.lang.Integer getInteger(String nm)
 Determines the integer value of the system property with the
specified name.
The first argument is treated as the name of a system property.
System properties are accessible through getProperty
and , a method defined by the System
class. The
string value of this property is then interpreted as an integer
value and an Integer
object representing this value is
returned. Details of possible numeric formats can be found with
the definition of getProperty
.
If there is no property with the specified name, or if the
property does not have the correct numeric format, then
null
is returned.
 Parameters:
 nm  property name.
 Returns:
 the
Integer
value of the property.
 Since:
 JDK1.0
 See Also:
 getProperty(java.lang.String), getProperty(java.lang.String, java.lang.String)
getInteger
public static java.lang.Integer getInteger(String nm,
int val)
 Determines the integer value of the system property with the
specified name.
The first argument is treated as the name of a system property.
System properties are accessible through getProperty
and , a method defined by the System
class. The
string value of this property is then interpreted as an integer
value and an Integer
object representing this value is
returned. Details of possible numeric formats can be found with
the definition of getProperty
.
If there is no property with the specified name, or if the
property does not have the correct numeric format, then an
Integer
object that represents the value of the
second argument is returned.
 Parameters:
 nm  property name.
 val  default value.
 Returns:
 the
Integer
value of the property.
 Since:
 JDK1.0
 See Also:
 getProperty(java.lang.String), getProperty(java.lang.String, java.lang.String)
getInteger
public static java.lang.Integer getInteger(String nm,
Integer val)
 Determines the integer value of the system property with the
specified name.
The first argument is treated as the name of a system property.
System properties are accessible through getProperty
and , a method defined by the System
class. The
string value of this property is then interpreted as an integer
value and an Integer
object representing this value is
returned.
If the property value begins with "0x
" or
"#
", not followed by a minus sign, the rest
of it is parsed as a hexadecimal integer exactly as for the method
Integer.valueOf
with radix 16.
If the property value begins with "0
" then
it is parsed as an octal integer exactly as for the method
Integer.valueOf
with radix 8.
Otherwise the property value is parsed as a decimal integer
exactly as for the method Integer.valueOf
with radix 10.
The second argument is the default value. If there is no property
of the specified name, or if the property does not have the
correct numeric format, then the second argument is returned.
 Parameters:
 nm  property name.
 val  default value.
 Returns:
 the
Integer
value of the property.
 Since:
 JDK1.0
 See Also:
 getProperty(java.lang.String), getProperty(java.lang.String, java.lang.String)
hashCode
public int hashCode()
 Returns a hashcode for this Integer.
 Returns:
 a hash code value for this object.
 Overrides:
 hashCode in class Object
 Since:
 JDK1.0
intValue
public int intValue()
 Returns the value of this Integer as an int.
 Returns:
 the
int
value represented by this object.
 Overrides:
 intValue in class Number
 Since:
 JDK1.0
longValue
public long longValue()
 Returns the value of this Integer as a long.
 Returns:
 the
int
value represented by this object that is
converted to type long
and the result of the
conversion is returned.
 Overrides:
 longValue in class Number
 Since:
 JDK1.0
parseInt
public static int parseInt(String s,
int radix) throws NumberFormatException
 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
Character.digit
returns a
nonnegative value), except that the first character may be an
ASCII minus sign ''
to indicate a negative value.
The resulting integer value is returned.
 Parameters:
 s  the
String
containing the integer.
 radix  the radix to be used.
 Returns:
 the integer represented by the string argument in the
specified radix.
 Throws: NumberFormatException
 if the string does not contain a
parsable integer.
 Since:
 JDK1.0
parseInt
public static int parseInt(String s) throws NumberFormatException
 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
''
to
indicate a negative value.
 Parameters:
 s  a string.
 Returns:
 the integer represented by the argument in decimal.
 Throws: NumberFormatException
 if the string does not contain a
parsable integer.
 Since:
 JDK1.0
shortValue
public short shortValue()
 Returns the value of this Integer as a short.
 Overrides:
 shortValue in class Number
 Since:
 JDK1.1
toBinaryString
public static java.lang.String toBinaryString(int i)
 Creates a string representation of the integer argument as an
unsigned integer in base 2.
The unsigned integer value is the argument plus 2^{32}if
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.
 Parameters:
 i  an integer.
 Returns:
 the string representation of the unsigned integer value
represented by the argument in binary (base 2).
 Since:
 JDK1.0.2
toHexString
public static java.lang.String toHexString(int i)
 Creates a string representation of the integer argument as an
unsigned integer in base 16.
The unsigned integer value is the argument plus 2^{32} 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.
 Parameters:
 i  an integer.
 Returns:
 the string representation of the unsigned integer value
represented by the argument in hexadecimal (base 16).
 Since:
 JDK1.0.2
toOctalString
public static java.lang.String toOctalString(int i)
 Creates a string representation of the integer argument as an
unsigned integer in base 8.
The unsigned integer value is the argument plus 2^{32} 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.
 Parameters:
 i  an integer
 Returns:
 the string representation of the unsigned integer value
represented by the argument in octal (base&mnsp;8).
 Since:
 JDK1.0.2
toString
public static java.lang.String toString(int i,
int radix)
 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 ''
. If the first
argument is not negative, no sign character appears in the result.
The following ASCII characters are used as digits:
0123456789abcdefghijklmnopqrstuvwxyz
 Parameters:
 i  an integer.
 radix  the radix.
 Returns:
 a string representation of the argument in the specified radix.
 Since:
 JDK1.0
 See Also:
 MAX_RADIX, MIN_RADIX
toString
public static java.lang.String toString(int i)
 Returns a new String object representing the specified integer. The radix
is assumed to be 10.
 Parameters:
 i  an integer to be converted.
 Returns:
 a string representation of the argument in base 10.
 Since:
 JDK1.0
toString
public java.lang.String toString()
 Returns a String object representing this Integer's value.
 Returns:
 a string representation of the value of this object in
base 10.
 Overrides:
 toString in class Object
 Since:
 JDK1.0
valueOf
public static java.lang.Integer valueOf(String s,
int radix) throws NumberFormatException
 Returns a new Integer object initialized to the value of the
specified String. Throws an exception if the String cannot be
parsed as an int.
 Parameters:
 s  the string to be parsed.
 Returns:
 a newly constructed
Integer
initialized to the
value represented by the string argument in the specified
radix.
 Throws: NumberFormatException
 if the
String
does not
contain a parsable integer.
 Since:
 JDK1.0
valueOf
public static java.lang.Integer valueOf(String s) throws NumberFormatException
 Returns a new Integer object initialized to the value of the
specified String. Throws an exception if the String cannot be
parsed as an int. The radix is assumed to be 10.
 Parameters:
 s  the string to be parsed.
 Returns:
 a newly constructed
Integer
initialized to the
value represented by the string argument.
 Throws: NumberFormatException
 if the string does not contain a
parsable integer.
 Since:
 JDK1.0
All Packages Class Hierarchy This Package Previous Next Index