Класс Integer

Все реализованные интерфейсы:
Serializable, Comparable<Integer> 
public final class Integer
extends Number
implements Comparable<Integer>

Класс Integer оборачивает значение примитивного типа int в объект. Объект типа Integer содержит единственное поле типа int.

Кроме того, этот класс предоставляет несколько методов для преобразования int в String и String в int, а также другие константы и методы, полезные при работе с int.

Примечание по реализации: Реализации методов "битовых трюков" (например, highestOneBit и numberOfTrailingZeros) основаны на материалах из книги Генри С. Уоррена-младшего "Hacker's Delight" (Addison Wesley, 2002).

С тех пор:
1.0
См. также:
Сериализованная форма

Поля

Модификатор и тип Поле Описание
static int BYTES

Количество байтов, используемых для представления значения int в двоичной форме со знаком.
static int MAX_VALUE

Константа, хранящая максимальное значение, которое может иметь int, 231-1.
static int MIN_VALUE

Константа, хранящая минимальное значение, которое может иметь int, -231.
static int SIZE

Количество битов, используемых для представления значения int в двоичной форме со знаком.
static Class<Integer> TYPE

Объект Class , представляющий примитивный тип int.

Конструкторы

Конструктор Описание
Integer​(int value)

Устаревший.

Использование этого конструктора редко уместно.
Integer​(String s)

Устаревший.

Использование этого конструктора редко уместно.

Методы

Модификатор и тип Метод Описание
static int bitCount​(int i)

Возвращает количество единичных битов в двоичном представлении числа со знаком, дополнительного кода, для указанного значения int.

byte byteValue()

Возвращает значение этого Integer в виде byte после сужения примитивного преобразования.
static int compare​(int x, int y)

Сравнивает два значения int численно.
int compareTo​(Integer anotherInteger)

Сравнивает два объекта Integer численно.
static int compareUnsigned​(int x, int y)

Сравнивает два значения int численно, рассматривая их как беззнаковые.
static Integer decode​(String nm)

Декодирует String в Integer.
static int divideUnsigned​(int dividend, int divisor)

Возвращает беззнаковый результат деления первого аргумента на второй, где каждый аргумент и результат интерпретируются как беззнаковое значение.
double doubleValue()

Возвращает значение этого Integer в виде double после расширяющего примитивного преобразования.
boolean equals​(Object obj)

Сравнивает этот объект с указанным объектом.
float floatValue()

Возвращает значение этого Integer в виде float после расширяющего примитивного преобразования.
static Integer getInteger​(String nm)

Определяет целое значение системной переменной с указанным именем.
static Integer getInteger​(String nm, int val)

Определяет целое значение системной переменной с указанным именем.
static Integer getInteger​(String nm, Integer val)

Возвращает целое значение системной переменной с указанным именем.
int hashCode()

Возвращает код хеширования для этого Integer.
static int hashCode​(int value)

Возвращает код хеширования для значения int; совместимо с Integer.hashCode().
static int highestOneBit​(int i)

Возвращает значение int с не более чем одним единичным битом в позиции старшего (самого левого) единичного бита в указанном значении int.
int intValue()

Возвращает значение этого Integer как int.
long longValue()

Возвращает значение этого Integer в виде long после расширяющего примитивного преобразования.
static int lowestOneBit​(int i)

Возвращает значение int с не более чем одним единичным битом в позиции младшего (самого правого) единичного бита в указанном значении int.
static int max​(int a, int b)

Возвращает большее из двух значений int так, как если бы вызывали Math.max.
static int min​(int a, int b)

Возвращает меньшее из двух значений int так, как если бы вызывали Math.min.
static int numberOfLeadingZeros​(int i)

Возвращает количество нулевых битов, предшествующих старшему (самому левому) единичному биту в двоичном представлении числа со знаком, дополнительного кода, для указанного значения int.
static int numberOfTrailingZeros​(int i)

Возвращает количество нулевых битов, следующих за младшим (самым правым) единичным битом в двоичном представлении числа со знаком, дополнительного кода, для указанного значения int.
static int parseInt​(CharSequence s, int beginIndex, int endIndex, int radix)

Парсит аргумент CharSequence как целое со знаком int в указанной radix, начиная с указанного beginIndex и до endIndex - 1.
static int parseInt​(String s)

Парсит строковый аргумент как целое десятичное число со знаком.
static int parseInt​(String s, int radix)

Парсит строковый аргумент как целое число со знаком в заданной системе счисления, определяемой вторым аргументом.
static int parseUnsignedInt​(CharSequence s, int beginIndex, int endIndex, int radix)

Парсит аргумент CharSequence как целое без знака int в указанной radix, начиная с указанного beginIndex и до endIndex - 1.
static int parseUnsignedInt​(String s)

Парсит строковый аргумент как целое беззнаковое десятичное число.
static int parseUnsignedInt​(String s, int radix)

Парсит строковый аргумент как целое без знака в заданной системе счисления, определяемой вторым аргументом.
static int remainderUnsigned​(int dividend, int divisor)

Возвращает беззнаковый остаток от деления первого аргумента на второй, где каждый аргумент и результат интерпретируются как беззнаковое значение.
static int reverse​(int i)

Возвращает значение, полученное путем инвертирования порядка битов в двоичном представлении числа со знаком, дополнительного кода, для указанного значения int.
static int reverseBytes​(int i)

Возвращает значение, полученное путем инвертирования порядка байтов в двоичном представлении числа со знаком, дополнительного кода, для указанного значения int.
static int rotateLeft​(int i, int distance)

Возвращает значение, полученное путем циклического сдвига влево двоичного представления числа со знаком, дополнительного кода, для указанного значения int на указанное количество битов.
static int rotateRight​(int i, int distance)

Возвращает значение, полученное путем циклического сдвига вправо двоичного представления числа со знаком, дополнительного кода, для указанного значения int на указанное количество битов.
short shortValue()

Возвращает значение этого Integer в виде short после сужения примитивного преобразования.
static int signum​(int i)

Возвращает функцию знака для указанного значения int.
static int sum​(int a, int b)

Складывает два целых числа в соответствии с оператором +.
static String toBinaryString​(int i)

Возвращает строковое представление целочисленного аргумента как беззнаковое целое число в двоичной системе счисления.
static String toHexString​(int i)

Возвращает строковое представление целочисленного аргумента как беззнаковое целое число в шестнадцатеричной системе счисления.
static String toOctalString​(int i)

Возвращает строковое представление целочисленного аргумента как беззнаковое целое число в восьмеричной системе счисления.
String toString()

Возвращает объект String, представляющий значение этого Integer.
static String toString​(int i)

Возвращает объект String, представляющий указанное целое число.
static String toString​(int i, int radix)

Возвращает строковое представление первого аргумента в системе счисления, заданной вторым аргументом.
static long toUnsignedLong​(int x)

Преобразует аргумент в long с помощью беззнакового преобразования.
static String toUnsignedString​(int i)

Возвращает строковое представление аргумента как беззнаковое десятичное значение.
static String toUnsignedString​(int i, int radix)

Возвращает строковое представление первого аргумента как беззнаковое целое значение в системе счисления, заданной вторым аргументом.
static Integer valueOf​(int i)

Возвращает экземпляр Integer, представляющий указанное значение int.
static Integer valueOf​(String s)

Возвращает объект Integer, содержащий значение указанного String.
static Integer valueOf​(String s, int radix)

Возвращает объект Integer, содержащий значение, извлечённое из указанного String при разборе с основанием, заданным вторым аргументом.

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Поля

MIN_VALUE

@Native
public static final int MIN_VALUE

Константа, содержащая минимальное значение, которое может иметь int, -231.

См. также:
Значения константных полей

MAX_VALUE

@Native
public static final int MAX_VALUE

Константа, содержащая максимальное значение, которое может иметь int, 231-1.

См. также:
Значения константных полей

TYPE

public static final Class<Integer> TYPE

Экземпляр Class, представляющий примитивный тип int.

С момента:
1.1

SIZE

@Native
public static final int SIZE

Количество битов, используемых для представления значения int в двоичной форме со знаком.

С момента:
1.5
См. также:
Значения константных полей

BYTES

public static final int BYTES

Количество байтов, используемых для представления значения int в двоичной форме со знаком.

С момента:
1.8
См. также:
Значения константных полей

Конструкторы

Integer

@Deprecated(since="9")
public Integer(int value)
Устаревший.
Использовать этот конструктор редко уместно. Статический фабричный метод valueOf(int) обычно является лучшим выбором, поскольку он, скорее всего, обеспечит значительно лучшую производительность в плане памяти и времени.

Создаёт новый объект Integer, представляющий указанное значение int.

Параметры:
value - значение, которое должен представлять объект Integer.

Integer

@Deprecated(since="9")
public Integer(String s)
        throws NumberFormatException
Устаревший.
Использовать этот конструктор редко уместно. Используйте parseInt(String) для преобразования строки в примитивное значение int, или используйте valueOf(String) для преобразования строки в объект Integer.

Создаёт новый объект Integer, представляющий значение int, указанное параметром String. Строка преобразуется в значение int точно так же, как это делает метод parseInt для основания 10.

Параметры:
s - строка, которая должна быть преобразована в значение Integer.
Исключения:
NumberFormatException - если строка не содержит целочисленного значения, которое можно распарсить.

Методы

toString

public static String toString(int i,
                              int radix)

Возвращает строковое представление первого аргумента в указанном основание по второму аргументу.

Если основание меньше Character.MIN_RADIX или больше Character.MAX_RADIX, то используется основание 10 вместо него.

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

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

0123456789abcdefghijklmnopqrstuvwxyz
Это символы от '\u0030' до '\u0039' и от '\u0061' до '\u007A'. Если radix равно N, то первые N из этих символов используются в качестве цифр в системе счисления с основанием N в указанном порядке. Таким образом, цифры для шестнадцатеричной системы (основание 16) являются 0123456789abcdef. Если требуются прописные буквы, можно вызвать метод String.toUpperCase() над результатом: 
Integer.toString(n, 16).toUpperCase()
Параметры:
i - целое число, которое нужно преобразовать в строку.
radix - основание, которое нужно использовать в строковом представлении.
Возвращает:
строковое представление аргумента в указанном основании.
См. также:
Character.MAX_RADIX, Character.MIN_RADIX

toUnsignedString

public static String toUnsignedString(int i,
                                      int radix)

Возвращает строковое представление первого аргумента как целого без знака в указанном основании по второму аргументу.

Если основание меньше Character.MIN_RADIX или больше Character.MAX_RADIX, то используется основание 10 вместо него.

Обратите внимание, что поскольку первый аргумент рассматривается как беззнаковое значение, ведущий знак не печатается.

Если величина равна нулю, она представляется одним нулевым символом '0' ('\u0030'); в противном случае, первый символ представления величины не будет нулевым символом.

Поведение оснований и символов, используемых в качестве цифр, такое же, как у toString.

Параметры:
i - целое число, которое нужно преобразовать в строку без знака.
radix - основание, которое нужно использовать в строковом представлении.
Возвращает:
строковое представление без знака аргумента в указанном основании.
С:
1.8
См. также:
toString(int, int)

toHexString

public static String toHexString(int i)

Возвращает строковое представление целочисленного аргумента как целого без знака в шестнадцатеричной системе счисления.

Целое без знака равно аргументу плюс 232, если аргумент отрицательный; в противном случае оно равно аргументу. Это значение преобразуется в строку ASCII-цифр в шестнадцатеричном (основание 16) формате без дополнительных ведущих 0.

Значение аргумента может быть восстановлено из возвращенной строки s вызовом Integer.parseUnsignedInt(s, 16).

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

0123456789abcdef
Это символы '\u0030' по '\u0039' и '\u0061' по '\u0066'. Если требуются прописные буквы, можно вызвать метод String.toUpperCase() над результатом: 
Integer.toHexString(n).toUpperCase()
Параметры:
i - целое число, которое нужно преобразовать в строку.
Возвращает:
строковое представление значения целого числа без знака, представленного аргументом в шестнадцатеричном (основание 16) формате.
С:
1.0.2
См. также:
parseUnsignedInt(String, int), toUnsignedString(int, int)

toOctalString

public static String toOctalString(int i)

Возвращает строковое представление целочисленного аргумента как целого без знака в восьмеричной системе счисления.

Целое без знака равно аргументу плюс 232, если аргумент отрицательный; в противном случае оно равно аргументу. Это значение преобразуется в строку ASCII-цифр в восьмеричном (основание 8) формате без дополнительных ведущих 0.

Значение аргумента может быть восстановлено из возвращенной строки s вызовом Integer.parseUnsignedInt(s, 8).

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

01234567
Это символы '\u0030' по '\u0037'.
Параметры:
i - целое число, которое нужно преобразовать в строку.
Возвращает:
строковое представление значения целого числа без знака, представленного аргументом в восьмеричном (основание 8) формате.
С:
1.0.2
См. также:
parseUnsignedInt(String, int), toUnsignedString(int, int)

toBinaryString

public static String toBinaryString(int i)

Возвращает строковое представление целочисленного аргумента как целого без знака в двоичной системе счисления.

Целое без знака равно аргументу плюс 232, если аргумент отрицательный; в противном случае оно равно аргументу. Это значение преобразуется в строку ASCII-цифр в двоичном (основание 2) формате без дополнительных ведущих 0.

Значение аргумента может быть восстановлено из возвращенной строки s вызовом Integer.parseUnsignedInt(s, 2).

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

Параметры:
i - целое число, которое нужно преобразовать в строку.
Возвращает:
строковое представление значения целого числа без знака, представленного аргументом в двоичном (основание 2) формате.
С:
1.0.2
См. также:
parseUnsignedInt(String, int), toUnsignedString(int, int)

toString

public static String toString(int i)

Возвращает объект String, представляющий указанное целое число. Аргумент преобразуется в знаковое десятичное представление и возвращается как строка, точно так же, как если бы аргумент и основание 10 были переданы как аргументы методу toString(int, int).

Параметры:
i - целое число, которое нужно преобразовать.
Возвращает:
строковое представление аргумента в системе счисления с основанием 10.

toUnsignedString

public static String toUnsignedString(int i)

Возвращает строковое представление аргумента как десятичного значения без знака. Аргумент преобразуется в десятичное представление без знака и возвращается как строка точно так же, как если бы аргумент и основание 10 были переданы как аргументы методу toUnsignedString(int, int).

Параметры:
i - целое число, которое нужно преобразовать в строку без знака.
Возвращает:
строковое представление без знака аргумента.
С:
1.8
См. также:
toUnsignedString(int, int)

parseInt

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

Парсит строковый аргумент как целое число со знаком в указанном основании по второму аргументу. Все символы в строке должны быть цифрами указанного основания (как определяется тем, возвращает ли Character.digit(char, int) положительное значение), за исключением того, что первый символ может быть ASCII-символом минуса '-' ('\u002D') для указания отрицательного значения или ASCII-символом плюса '+' ('\u002B') для указания положительного значения. Возвращается полученное целое значение.

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

  • Первый аргумент пустой или строка нулевой длины.
  • Основание меньше Character.MIN_RADIX или больше Character.MAX_RADIX.
  • Любой символ строки не является цифрой указанного основания, за исключением первого символа, который может быть знаком минус '-' ('\u002D') или знаком плюс '+' ('\u002B') при условии, что длина строки больше 1.
  • Значение, представленное строкой, не является значением типа int.

Примеры: 

parseInt("0", 10) returns 0
parseInt("473", 10) returns 473
parseInt("+42", 10) returns 42
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 - строка, содержащая целочисленное представление, которое нужно проанализировать
radix - основание, которое нужно использовать при парсинге s.
Возвращает:
целое число, представленное строковым аргументом в указанном основании.
Исключение:
NumberFormatException - если строка не содержит анализируемого int.

parseInt

public static int parseInt(CharSequence s,
                           int beginIndex,
                           int endIndex,
                           int radix)
                    throws NumberFormatException

Парсит аргумент типа CharSequence как знаковое int в указанном radix, начиная с указанного beginIndex и до endIndex - 1.

Метод не предпринимает мер по защите от изменения CharSequence во время парсинга.

Параметры:
s - строка CharSequence, содержащая представление int для разбора
beginIndex - начальный индекс, включительно.
endIndex - конечный индекс, исключая.
radix - основание, используемое при разборе s.
Возвращает:
целое int, представленное подпоследовательностью в указанном основании.
Выбрасывает:
NullPointerException - если s равно null.
IndexOutOfBoundsException - если beginIndex отрицательно, или если beginIndex больше endIndex, или если endIndex больше s.length().
NumberFormatException - если строка CharSequence не содержит разбираемого int в указанном radix, или если radix меньше Character.MIN_RADIX или больше Character.MAX_RADIX.
С:
9

parseInt

public static int parseInt(String s)
                    throws NumberFormatException

Разбирает строковый аргумент как целое десятичное число со знаком. Символы в строке должны быть десятичными цифрами, за исключением первого символа, который может быть ASCII-минусом '-' ('\u002D') для указания отрицательного значения или ASCII-плюсом '+' ('\u002B') для указания положительного значения. Полученное целочисленное значение возвращается точно так же, как если бы аргумент и основание 10 были переданы в метод parseInt(java.lang.String, int).

Параметры:
s - строка, содержащая представление int для разбора
Возвращает:
целое значение, представленное аргументом в десятичной системе.
Выбрасывает:
NumberFormatException - если строка не содержит разбираемого целого числа.

parseUnsignedInt

public static int parseUnsignedInt(String s,
                                   int radix)
                            throws NumberFormatException

Разбирает строковый аргумент как целое без знака в основании, заданном вторым аргументом. Целое без знака отображает значения, обычно связанные с отрицательными числами, на положительные числа, большие, чем MAX_VALUE. Символы в строке должны быть цифрами указанного основания (как определяется тем, возвращает ли Character.digit(char, int) неотрицательное значение), за исключением первого символа, который может быть ASCII-плюсом '+' ('\u002B'). Возвращается полученное целочисленное значение.

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

  • Первый аргумент равен null или является строкой длиной ноль.
  • Основание меньше Character.MIN_RADIX или больше Character.MAX_RADIX.
  • Любой символ строки не является цифрой указанного основания, за исключением первого символа, который может быть знаком плюс '+' ('\u002B'), при условии, что длина строки больше 1.
  • Значение, представленное строкой, больше наибольшего целого без знака int, 232-1.
Параметры:
s - строка, содержащая представление целого без знака для разбора
radix - основание, используемое при разборе s.
Возвращает:
целое число, представленное строковым аргументом в указанном основании.
Выбрасывает:
NumberFormatException - если строка не содержит разбираемого целого без знака.
С:
1.8

parseUnsignedInt

public static int parseUnsignedInt(CharSequence s,
                                   int beginIndex,
                                   int endIndex,
                                   int radix)
                            throws NumberFormatException

Разбирает аргумент CharSequence как целое без знака int в указанном radix, начиная с указанного beginIndex и до endIndex - 1.

Метод не предпринимает шагов для защиты от изменения CharSequence во время разбора.

Параметры:
s - строка, содержащая представление целого без знака для разбора
beginIndex - начальный индекс, включительно.
endIndex - конечный индекс, исключая.
radix - основание, используемое при разборе s.
Возвращает:
целое без знака int, представленное подпоследовательностью в указанном основании.
Выбрасывает:
NullPointerException - если s равно null.
IndexOutOfBoundsException - если beginIndex отрицательно, или если beginIndex больше endIndex, или если endIndex больше s.length().
NumberFormatException - если строка CharSequence не содержит разбираемого целого без знака int в указанном radix, или если radix меньше Character.MIN_RADIX или больше Character.MAX_RADIX.
С:
9

parseUnsignedInt

public static int parseUnsignedInt(String s)
                            throws NumberFormatException

Разбирает строковый аргумент как целое десятичное число без знака. Символы в строке должны быть десятичными цифрами, за исключением первого символа, который может быть ASCII-плюсом '+' ('\u002B'). Возвращается полученное целочисленное значение, точно так же, как если бы аргумент и основание 10 были переданы в метод parseUnsignedInt(java.lang.String, int).

Параметры:
s - строка, содержащая представление целого без знака для разбора
Возвращает:
значение целого без знака, представленное аргументом в десятичной системе.
Выбрасывает:
NumberFormatException - если строка не содержит разбираемого целого без знака.
С:
1.8

valueOf

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

Возвращает объект Integer, содержащий значение, извлечённое из указанной строки String, при разборе с основанием, заданным вторым аргументом. Первый аргумент интерпретируется как представляющий целое со знаком в основании, заданном вторым аргументом, точно так же, как если бы аргументы были переданы методу parseInt(java.lang.String, int). Результатом является объект Integer, представляющий целочисленное значение, указанное строкой.

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

new Integer(Integer.parseInt(s, radix))
Параметры:
s - строка для разбора.
radix - основание, используемое для интерпретации s
Возвращает:
объект Integer, содержащий значение, представленное строковым аргументом в заданном основании.
Выбрасывает:
NumberFormatException - если строка не содержит разбираемого целого числа.

valueOf

public static Integer valueOf(String s)
                       throws NumberFormatException

Возвращает объект Integer, содержащий значение указанной строки String. Аргумент интерпретируется как представление целого десятичного числа со знаком, точно так же, как если бы аргумент был передан методу parseInt(java.lang.String). Результатом является объект Integer, представляющий целое значение, указанное строкой.

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

new Integer(Integer.parseInt(s))
Параметры:
s - строка для разбора.
Возвращает:
объект Integer, содержащий значение, представленное строковым аргументом.
Выбрасывает:
NumberFormatException - если строка не может быть разобрана как целое число.

valueOf

public static Integer valueOf(int i)

Возвращает экземпляр Integer, представляющий заданное значение int. Если новый экземпляр Integer не требуется, этот метод обычно следует использовать вместо конструктора Integer(int), так как этот метод, вероятно, обеспечит значительно лучшую производительность по памяти и времени, кешируя часто запрашиваемые значения. Этот метод всегда будет кэшировать значения в диапазоне от -128 до 127 включительно и может кэшировать другие значения за пределами этого диапазона.

Параметры:
i - значение int.
Возвращает:
экземпляр Integer, представляющий i.
С:
1.5

byteValue

public byte byteValue()

Возвращает значение этого Integer как byte после сужения примитивного преобразования.

Переопределяет:
byteValue в классе Number
Возвращает:
числовое значение, представленное этим объектом после преобразования в тип byte.

shortValue

public short shortValue()

Возвращает значение этого Integer как short после сужения примитивного преобразования.

Переопределяет:
shortValue в классе Number
Возвращает:
числовое значение, представленное этим объектом после преобразования в тип short.

intValue

public int intValue()

Возвращает значение этого Integer как int.

Определено в:
intValue в классе Number
Возвращает:
числовое значение, представленное этим объектом после преобразования в тип int.

longValue

public long longValue()

Возвращает значение этого Integer как long после расширения примитивного преобразования.

Определено в:
longValue в классе Number
Возвращает:
числовое значение, представленное этим объектом после преобразования в тип long.
См. также:
toUnsignedLong(int)

floatValue

public float floatValue()

Возвращает значение этого Integer в виде float после расширяющего преобразования примитивного типа.

Определено в:
floatValue в классе Number
Возвращает:
числовое значение, представленное этим объектом после преобразования к типу float.

doubleValue

public double doubleValue()

Возвращает значение этого Integer в виде double после расширяющего преобразования примитивного типа.

Определено в:
doubleValue в классе Number
Возвращает:
числовое значение, представленное этим объектом после преобразования к типу double.

toString

public String toString()

Возвращает объект String , представляющий значение этого Integer. Значение преобразуется в десятичное представление со знаком и возвращается в виде строки точно так же, как если бы целое значение было передано в качестве аргумента методу toString(int).

Переопределяет:
toString в классе Object
Возвращает:
строковое представление значения этого объекта в системе счисления по основанию 10.

hashCode

public int hashCode()

Возвращает код хэша для этого Integer.

Переопределяет:
hashCode в классе Object
Возвращает:
значение кода хэша для этого объекта, равное значению примитивного int , представленному этим объектом Integer.
См. также:
Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

hashCode

public static int hashCode(int value)

Возвращает код хэша для значения int; совместимо с Integer.hashCode().

Параметры:
value - значение, для которого требуется вычислить код хэша
Возвращает:
значение кода хэша для значения int.
С тех пор:
1.8

equals

public boolean equals(Object obj)

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

Переопределяет:
equals в классе Object
Параметры:
obj - объект для сравнения.
Возвращает:
true , если объекты одинаковые; false в противном случае.
См. также:
Object.hashCode(), HashMap

getInteger

public static Integer getInteger(String nm)

Определяет целое значение системной переменной с указанным именем.

Первый аргумент рассматривается как имя системной переменной. Доступ к системным переменным осуществляется через метод System.getProperty(java.lang.String). Затем строковое значение этой переменной интерпретируется как целое число с использованием грамматики, поддерживаемой decode, и возвращается объект Integer , представляющий это значение.

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

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

getInteger(nm, null)
Параметры:
nm - имя переменной.
Возвращает:
значение Integer переменной.
Исключения:
SecurityException - по тем же причинам, что и System.getProperty
См. также:
System.getProperty(java.lang.String), System.getProperty(java.lang.String, java.lang.String)

getInteger

public static Integer getInteger(String nm,
                                 int val)

Определяет целое значение системной переменной с указанным именем.

Первый аргумент рассматривается как имя системной переменной. Доступ к системным переменным осуществляется через метод System.getProperty(java.lang.String). Затем строковое значение этой переменной интерпретируется как целое число с использованием грамматики, поддерживаемой decode, и возвращается объект Integer , представляющий это значение.

Второй аргумент — значение по умолчанию. Возвращается объект Integer , представляющий значение второго аргумента, если переменной с указанным именем нет, если переменная не имеет правильного числового формата или если указанное имя пустое или null.

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

getInteger(nm, new Integer(val))
но на практике он может быть реализован так, как: 
Integer result = getInteger(nm, null);
return (result == null) ? new Integer(val) : result;
чтобы избежать ненужного выделения объекта Integer , когда значение по умолчанию не нужно.
Параметры:
nm - имя переменной.
val - значение по умолчанию.
Возвращает:
значение Integer переменной.
Исключения:
SecurityException - по тем же причинам, что и System.getProperty
См. также:
System.getProperty(java.lang.String), System.getProperty(java.lang.String, java.lang.String)

getInteger

public static Integer getInteger(String nm,
                                 Integer val)

Возвращает целое значение системной переменной с указанным именем. Первый аргумент интерпретируется как имя системной переменной. Доступ к системным переменным осуществляется через метод System.getProperty(java.lang.String). Строковое значение этой переменной интерпретируется как целое число, согласно методу decode, и возвращается объект Integer , представляющий это значение; коротко:

  • Если значение переменной начинается с двух ASCII-символов 0x или ASCII-символа #, не после которого не стоит знак минус, то остальная часть анализируется как шестнадцатеричное целое число точно так же, как методом valueOf(java.lang.String, int) с основанием 16.
  • Если значение переменной начинается с ASCII-символа 0 , за которым следует другой символ, оно анализируется как восьмеричное целое число точно так же, как методом valueOf(java.lang.String, int) с основанием 8.
  • В противном случае значение переменной анализируется как десятичное целое число точно так же, как методом valueOf(java.lang.String, int) с основанием 10.

Второй аргумент — значение по умолчанию. Значение по умолчанию возвращается, если переменной с указанным именем нет, если переменная не имеет правильного числового формата или если указанное имя пустое или null.

Параметры:
nm - имя переменной.
val - значение по умолчанию.
Возвращает:
значение Integer переменной.
Исключения:
SecurityException - по тем же причинам, что и System.getProperty
См. также:
System.getProperty(java.lang.String), System.getProperty(java.lang.String, java.lang.String)

decode

public static Integer decode(String nm)
                      throws NumberFormatException

Декодирует String в Integer. Принимает десятичные, шестнадцатеричные и восьмеричные числа, задаваемые следующей грамматикой:

Декодируемая строка:
Знакнеобязательно Десятичное число
Знакнеобязательно 0x Шестнадцатеричные цифры
Знакнеобязательно 0X Шестнадцатеричные цифры
Знакнеобязательно # Шестнадцатеричные цифры
Знакнеобязательно 0 Восьмеричные цифры
Знак:
-
+
Десятичное число, Шестнадцатеричные цифры и Восьмеричные цифры определены в разделе 3.10.1 спецификации языка Java™, за исключением того, что подчёркивания между цифрами не допускаются.

Последовательность символов после необязательного знака и/или спецификатора основания ("0x", "0X", "#" или ведущая нуль) анализируется методом Integer.parseInt с указанным основанием (10, 16 или 8). Эта последовательность символов должна представлять положительное значение, в противном случае будет выброшено исключение NumberFormatException. Результат меняется на обратный, если первый символ указанного String является знаком минус. В String не допускаются пробелы.

Параметры:
nm - String для декодирования.
Возвращает:
объект Integer , содержащий значение int , представленное nm
Исключения:
NumberFormatException - если String не содержит анализируемое целое число.
См. также:
parseInt(java.lang.String, int)

compareTo

public int compareTo(Integer anotherInteger)

Сравнивает два объекта Integer численно.

Определено в:
compareTo в интерфейсе Comparable<Integer>
Параметры:
anotherInteger - объект Integer для сравнения.
Возвращает:
значение 0 , если этот объект Integer равен аргументу Integer; значение меньше 0 , если этот объект Integer численно меньше аргумента Integer; и значение больше 0 , если этот объект Integer численно больше аргумента Integer (сравнение со знаком).
С тех пор:
1.2

compare

public static int compare(int x,
                          int y)

Сравнивает два значения int численно. Возвращаемое значение идентично тому, что было бы возвращено: 

Integer.valueOf(x).compareTo(Integer.valueOf(y))

Параметры:
x - первое int для сравнения
y - второе int для сравнения
Возвращает:
значение 0 если x == y; значение меньше 0 если x < y; и значение больше 0 если x > y
С:
1.7

compareUnsigned

public static int compareUnsigned(int x,
                                  int y)

Сравнивает два значения int численно, рассматривая значения как беззнаковые.

Параметры:
x - первое int для сравнения
y - второе int для сравнения
Возвращает:
значение 0 если x == y; значение меньше 0 если x < y как беззнаковые значения; и значение больше 0 если x > y как беззнаковые значения
С:
1.8

toUnsignedLong

public static long toUnsignedLong(int x)

Преобразует аргумент в long с помощью беззнакового преобразования. При беззнаковом преобразовании в long, старшие 32 бита long равны нулю, а младшие 32 бита равны битам целочисленного аргумента. Следовательно, нулевые и положительные значения int отображаются на численно равное значение long, а отрицательные значения int отображаются на значение long равное вводу плюс 232.

Параметры:
x - значение для преобразования в беззнаковое long
Возвращает:
аргумент, преобразованный в long с помощью беззнакового преобразования
С:
1.8

divideUnsigned

public static int divideUnsigned(int dividend,
                                 int divisor)

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

Обратите внимание, что в арифметике со знаком «дополнения до двух» три других основных арифметических операции — сложение, вычитание и умножение — побитово идентичны, если оба операнда рассматриваются как со знаком или оба без знака. Поэтому отдельные методы addUnsigned, и т.д. не предоставляются.

Параметры:
dividend - значение, которое нужно разделить
divisor - значение, на которое нужно разделить
Возвращает:
беззнаковое частное от деления первого аргумента на второй аргумент
С:
1.8
См. также:
remainderUnsigned(int, int)

remainderUnsigned

public static int remainderUnsigned(int dividend,
                                    int divisor)

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

Параметры:
dividend - значение, которое нужно разделить
divisor - значение, на которое нужно разделить
Возвращает:
беззнаковый остаток от деления первого аргумента на второй аргумент
С:
1.8
См. также:
divideUnsigned(int, int)

highestOneBit

public static int highestOneBit(int i)

Возвращает значение int с максимум одним битом «единица», в позиции старшего («левого») бита «единица» в указанном значении int. Возвращает ноль, если указанное значение не имеет битов «единица» в представлении со знаком «дополнения до двух», то есть если оно равно нулю.

Параметры:
i - значение, для которого требуется вычислить старший бит «единица»
Возвращает:
значение int с одним битом «единица» в позиции старшего бита «единица» в указанном значении или ноль, если указанное значение само по себе равно нулю.
С:
1.5

lowestOneBit

public static int lowestOneBit(int i)

Возвращает значение int с максимум одним битом «единица», в позиции младшего («правого») бита «единица» в указанном значении int . Возвращает ноль, если указанное значение не имеет битов «единица» в представлении со знаком «дополнения до двух», то есть если оно равно нулю.

Параметры:
i - значение, для которого требуется вычислить младший бит «единица»
Возвращает:
значение int с одним битом «единица» в позиции младшего бита «единица» в указанном значении или ноль, если указанное значение само по себе равно нулю.
С:
1.5

numberOfLeadingZeros

public static int numberOfLeadingZeros(int i)

Возвращает количество нулевых битов, предшествующих старшему («левому») биту «единица» в двоичном представлении со знаком «дополнения до двух» указанного значения int. Возвращает 32, если указанное значение не имеет битов «единица» в представлении со знаком «дополнения до двух», другими словами, если оно равно нулю.

Обратите внимание, что этот метод тесно связан с логарифмом по основанию 2. Для всех положительных значений int x:

  • floor(log2(x)) = 31 - numberOfLeadingZeros(x)
  • ceil(log2(x)) = 32 - numberOfLeadingZeros(x - 1)
Параметры:
i - значение, для которого требуется вычислить количество старших нулей
Возвращает:
количество нулевых битов, предшествующих старшему («левому») биту «единица» в двоичном представлении со знаком «дополнения до двух» указанного значения int , или 32, если значение равно нулю.
С:
1.5

numberOfTrailingZeros

public static int numberOfTrailingZeros(int i)

Возвращает количество нулевых битов, следующих за младшим («правым») битом «единица» в двоичном представлении со знаком «дополнения до двух» указанного значения int . Возвращает 32, если указанное значение не имеет битов «единица» в представлении со знаком «дополнения до двух», другими словами, если оно равно нулю.

Параметры:
i - значение, для которого требуется вычислить количество младших нулей
Возвращает:
количество нулевых битов, следующих за младшим («правым») битом «единица» в двоичном представлении со знаком «дополнения до двух» указанного значения int , или 32, если значение равно нулю.
С:
1.5

bitCount

public static int bitCount(int i)

Возвращает количество битов «единица» в двоичном представлении со знаком «дополнения до двух» указанного значения int . Эта функция иногда называется счетчиком популяции.

Параметры:
i - значение, биты которого нужно посчитать
Возвращает:
количество битов «единица» в двоичном представлении со знаком «дополнения до двух» указанного значения int .
С:
1.5

rotateLeft

public static int rotateLeft(int i,
                             int distance)

Возвращает значение, полученное путем циклического сдвига влево двоичного представления со знаком «дополнения до двух» указанного значения int на указанное количество битов. (Бит, смещенный из левой, или старшей, стороны, возвращается вправо, или младшую.)

Обратите внимание, что циклический сдвиг влево с отрицательным расстоянием эквивалентен циклическому сдвигу вправо: rotateLeft(val, -distance) == rotateRight(val, distance). Также обратите внимание, что циклический сдвиг на любое кратное 32 — это операция без действия, поэтому можно игнорировать все, кроме последних пяти битов расстояния сдвига, даже если расстояние отрицательное: rotateLeft(val, distance) == rotateLeft(val, distance & 0x1F).

Параметры:
i - значение, биты которого необходимо сдвинуть влево
distance - количество позиций битов для сдвига влево
Возвращает:
значение, полученное путем циклического сдвига влево двоичного представления со знаком «дополнения до двух» указанного значения int на указанное количество битов.
С:
1.5

rotateRight

public static int rotateRight(int i,
                              int distance)

Возвращает значение, полученное путем циклического сдвига вправо двоичного представления со знаком «дополнения до двух» указанного значения int на указанное количество битов. (Бит, смещенный из правой, или младшей, стороны, возвращается влево, или старшую.)

Обратите внимание, что циклический сдвиг вправо с отрицательным расстоянием эквивалентен циклическому сдвигу влево: rotateRight(val, -distance) == rotateLeft(val, distance). Также обратите внимание, что циклический сдвиг на любое кратное 32 — это операция без действия, поэтому можно игнорировать все, кроме последних пяти битов расстояния сдвига, даже если расстояние отрицательное: rotateRight(val, distance) == rotateRight(val, distance & 0x1F).

Параметры:
i - значение, биты которого необходимо сдвинуть вправо
distance - количество позиций битов для сдвига вправо
Возвращает:
значение, полученное путем циклического сдвига вправо двоичного представления со знаком «дополнения до двух» указанного значения int на указанное количество битов.
С:
1.5

reverse

public static int reverse(int i)

Возвращает значение, полученное путем инвертирования порядка битов в двоичном представлении со знаком «дополнения до двух» указанного значения int .

Параметры:
i - значение, которое необходимо инвертировать
Возвращает:
значение, полученное путем инвертирования порядка битов в указанном значении int .
С:
1.5

signum

public static int signum(int i)

Возвращает функцию знака указанного значения int . (Возвращаемое значение равно -1, если указанное значение отрицательно; 0, если указанное значение равно нулю; и 1, если указанное значение положительно.)

Параметры:
i - значение, для которого нужно вычислить функцию знака
Возвращает:
функция знака указанного значения int .
С:
1.5

reverseBytes

public static int reverseBytes(int i)

Возвращает значение, полученное путем инвертирования порядка байтов в представлении со знаком «дополнения до двух» указанного значения int .

Параметры:
i - значение, байты которого необходимо инвертировать
Возвращает:
значение, полученное путем инвертирования байтов в указанном значении int .
С:
1.5

sum

public static int sum(int a,
                      int b)

Складывает два целых числа в соответствии с оператором +.

Параметры:
a - первый операнд
b - второй операнд
Возвращает:
сумма a и b
С:
1.8
См. также:
BinaryOperator

max

public static int max(int a,
                      int b)

Возвращает большее из двух int значений, как если бы вызывался Math.max.

Параметры:
a - первый операнд
b - второй операнд
Возвращает:
большее из a и b
С:
1.8
См. также:
BinaryOperator

min

public static int min(int a,
                      int b)

Возвращает меньшее из двух int значений, как если бы вызывался Math.min.

Параметры:
a - первый операнд
b - второй операнд
Возвращает:
меньшее из a и b
С:
1.8
См. также:
BinaryOperator

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Integer.html

Spec-Zone .ru
спецификации, руководства, описания, API