Spec-Zone .ru
спецификации, руководства, описания, API
Содержание | Предыдущий | Следующий | Индекс

20.7 Класс java.lang.Integer

public final class Integer extends Number {
	public static final int MIN_VALUE = 0x80000000;
	public static final int MAX_VALUE = 0x7fffffff;
	public Integer(int value);
	public Integer(String s)
throws NumberFormatException; public String toString(); public boolean equals(Object obj); public int hashCode(); public int intValue(); public long longValue(); public float floatValue(); public double doubleValue(); public static String toString(int i); public static String toString(int i, int radix); public static String toHexString(long i); public static String toOctalString(long i); public static String toBinaryString(long i); public static int parseInt(String s)
throws NumberFormatException; public static int parseInt(String s, int radix)
throws NumberFormatException; public static Integer valueOf(String s)
throws NumberFormatException; public static Integer valueOf(String s, int radix)
throws NumberFormatException; public static Integer getInteger(String nm); public static Integer getInteger(String nm, int val); public static Integer getInteger(String nm, Integer val); }

20.7.1 public static final int MIN_VALUE = 0x80000000;

Постоянная величина этого поля -2147483648, самое низкое значение типа int.

20.7.2 public static final int MAX_VALUE = 0x7fffffff;

Постоянная величина этого поля 2147483647, самое высокое значение типа int.

20.7.3 public Integer(int value)

Этот конструктор инициализирует недавно создаваемый Integer возразите так, чтобы это представило примитивное значение, которое является параметром.

20.7.4 public Integer(String s) throws NumberFormatException

Этот конструктор инициализирует недавно создаваемый Integer возразите так, чтобы это представило целое число, представленное строкой в десятичной форме. Строка преобразовывается в int точно способом, используемым parseInt метод (§20.7.18) для основания 10.

20.7.5 public String toString()

Целочисленное значение представляется этим Integer объект преобразовывается в десятичное представление со знаком и возвращается как строка, точно как будто целочисленное значение было дано как параметр toString метод, который берет один параметр (§20.7.12).

Переопределения toString метод Object (§20.1.2).

20.7.6 public boolean equals(Object obj)

Результат true если и только если параметр не null и Integer объект, который представляет то же самое int оцените как это Integer объект.

Переопределения equals метод Object (§20.1.3).

20.7.7 public int hashCode()

Результатом является примитив int значение представляется этим Integer объект.

Переопределения hashCode метод Object (§20.1.4).

20.7.8 public int intValue()

int значение представляется этим Integer объект возвращается.

Переопределения intValue метод Number (§20.6.1).

20.7.9 public long longValue()

int значение представляется этим Integer объект преобразовывается (§5.1.2), чтобы ввести long и результат преобразования возвращается.

Переопределения longValue метод Number (§20.6.2).

20.7.10 public float floatValue()

int значение представляется этим Integer объект преобразовывается (§5.1.2), чтобы ввести float и результат преобразования возвращается.

Переопределения floatValue метод Number (§20.6.3).

20.7.11 public double doubleValue()

int значение представляется этим Integer объект преобразовывается (§5.1.2), чтобы ввести double и результат преобразования возвращается.

Переопределения doubleValue метод Number (§20.6.4).

20.7.12 public static String toString(int i)

Параметр преобразовывается в десятичное представление со знаком и возвращается как строка, точно как будто параметр и основание 10 были даны как параметры toString метод, который берет два параметра (§20.7.13).

20.7.13 public static String toString(int i, int radix)

Первый параметр преобразовывается в представление со знаком в основании, определенном вторым параметром; это представление возвращается как строка.

Если radix меньше чем Character.MIN_RADIX (§20.5.3) или больше чем Character.MAX_RADIX (§20.5.4), тогда значение 10 используется вместо этого.

Если первый параметр будет отрицателен, то первый символ результата будет символом '-' ('\u002d'). Если первый параметр не отрицателен, никакой символ знака не появляется в результате.

Остающиеся символы результата представляют величину первого параметра. Если величина является нулем, она представляется единственным нулевым символом '0' ('\u0030'); иначе, первый символ представления величины не будет нулевым символом. Следующие символы ASCII используются в качестве цифр:

0123456789abcdefghijklmnopqrstuvwxyz
Они '\u0030' через '\u0039' и '\u0061' через '\u007a'. Если radix N, тогда первые N этих символов используются в качестве цифр основания-N в показанном порядке. Таким образом цифры для шестнадцатеричного (основание 16) 0123456789abcdef. Если прописные буквы требуются, toUpperCase метод (§20.12.36) класса String может быть вызван на результате:

Integer.toString(n, 16).toUpperCase()

20.7.14 public static String toHexString(int i)

Параметр преобразовывается в представление без знака в шестнадцатеричном основании (базируйтесь 16); это представление возвращается как строка.

Результат представляет величину без знака параметра. Это равняется параметру плюс то, если параметр отрицателен; иначе, это равняется параметру.

Если величина без знака является нулем, она представляется единственным нулевым символом '0' ('\u0030'); иначе, первый символ представления величины без знака не будет нулевым символом. Следующие символы используются в качестве шестнадцатеричных цифр:

0123456789abcdef
Они - символы '\u0030' через '\u0039' и '\u0061' через '\u0066'. Если прописные буквы требуются, toUpperCase метод (§20.12.36) класса String может быть вызван на результате:

Long.toHexString(n).toUpperCase()

20.7.15 public static String toOctalString(int i)

Параметр преобразовывается в представление без знака в восьмеричном основании (базируйтесь 8); это представление возвращается как строка.

Результат представляет величину без знака параметра. Это равняется параметру плюс то, если параметр отрицателен; иначе, это равняется параметру.

Если величина без знака является нулем, она представляется единственным нулевым символом '0' ('\u0030'); иначе, первый символ представления величины без знака не будет нулевым символом. Восьмеричные цифры:

01234567
Они - символы '\u0030' через '\u0037'.

20.7.16 public static String toBinaryString(int i)

Параметр преобразовывается в представление без знака в двоичном основании (базируйтесь 2); это представление возвращается как строка.

Результат представляет величину без знака параметра. Это равняется параметру плюс то, если параметр отрицателен; иначе, это равняется параметру.

Если величина без знака является нулем, она представляется единственным нулевым символом '0' ('\u0030'); иначе, первый символ представления величины без знака не будет нулевым символом. Символы '0' ('\u0030') и '1' ('\u0031') используются в качестве двоичных цифр.

20.7.17 public static int parseInt(String s)
throws NumberFormatException

Параметр интерпретируется как представление десятичного целого числа со знаком. Компоненты строки должны все быть десятичными цифрами, за исключением того, что первый символ может быть '-' ('\u002d') указать на отрицательную величину. Получающееся целочисленное значение возвращается, точно как будто параметр и основание 10 были даны как параметры parseInt метод, который берет два параметра (§20.7.18).

20.7.18 public static int parseInt(String s, int radix)
throws NumberFormatException

Первый параметр интерпретируется как представление целого числа со знаком в основании, определенном вторым параметром. Компоненты строки должны все быть цифрами указанного основания (как определено, ли Character.digit (§20.5.23) возвращает неотрицательное значение), за исключением того, что первый символ может быть '-' ('\u002d') указать на отрицательную величину. Получающееся целочисленное значение возвращается.

Исключение типа NumberFormatException бросается, если какая-либо из следующих ситуаций происходит:

Примеры:


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

20.7.19 public static Integer valueOf(String s)
throws NumberFormatException

Параметр интерпретируется как представление десятичного целого числа со знаком, точно как будто параметр был дан parseInt метод, который берет один параметр (§20.7.17). Результат Integer объект, который представляет целочисленное значение, определенное строкой.

Другими словами этот метод возвращается Integer возразите равный значению:

new Integer(Integer.parseInt(s))

20.7.20 public static Integer valueOf(String s, int radix)
throws NumberFormatException

Первый параметр интерпретируется как представление целого числа со знаком в основании, определенном вторым параметром, точно как будто параметры были даны parseInt метод, который берет два параметра (§20.7.18). Результат Integer объект, который представляет целочисленное значение, определенное строкой.

Другими словами этот метод возвращается Integer возразите равный значению:

new Integer(Integer.parseInt(s, radix))

20.7.21 public static Integer getInteger(String nm)

Первый параметр обрабатывается как имя системного свойства, которое будет получено как будто методом System.getProperty (§20.18.9). Строковое значение этого свойства тогда интерпретируется как целочисленное значение и Integer объект, представляющий это значение, возвращается. Если нет никакого свойства указанного имени, или если у свойства нет корректного числового формата, то null возвращается.

Другими словами этот метод возвращается Integer возразите равный значению:

getInteger(nm, null)

20.7.22 public static Integer getInteger(String nm, int val)

Первый параметр обрабатывается как имя системного свойства, которое будет получено как будто методом System.getProperty (§20.18.9). Строковое значение этого свойства тогда интерпретируется как целочисленное значение и Integer объект, представляющий это значение, возвращается. Если у свойства нет корректного числового формата, то Integer объект, который представляет значение второго параметра, возвращается.

Другими словами этот метод возвращается Integer возразите равный значению:

getInteger(nm, new Integer(val))
но практически это может быть реализовано способом, таким как:


Integer result = getInteger(nm, null);
return (result == null) ? new Integer(val) : result;
избегать ненужного выделения Integer возразите, когда значение по умолчанию не необходимо.

20.7.23 public static Integer getInteger(String nm, Integer val)

Первый параметр обрабатывается как имя системного свойства, которое будет получено как будто методом System.getProperty (§20.18.9). Строковое значение этого свойства тогда интерпретируется как целочисленное значение и Integer объект, представляющий это значение, возвращается.

Второй параметр служит значением по умолчанию. Если нет никакого свойства указанного имени, или если у свойства нет корректного числового формата, то второй параметр возвращается.


Содержание | Предыдущий | Следующий | Индекс

Спецификация языка Java (HTML, сгенерированный Блинчиком "сюзет" Pelouch 24 февраля 1998)
Авторское право © Sun Microsystems, Inc 1996 года. Все права защищены
Пожалуйста, отправьте любые комментарии или исправления к doug.kramer@sun.com

free hit counter