Класс Integer

java.lang.Object
- java.lang.Number
- - java.lang.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).

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

Поля

Модификатор и тип	Поле и описание
`static int`	`BYTES` Количество байтов, используемых для представления значения `int` в двоичной форме со знаком.
`static int`	`MAX_VALUE` Константа, содержащая максимальное значение, которое может иметь `int`, 2³¹-1.
`static int`	`MIN_VALUE` Константа, содержащая минимальное значение, которое может иметь `int`, -2³¹.
`static int`	`SIZE` Количество бит, используемых для представления значения `int` в двоичной форме со знаком.
`static Class<Integer>`	`TYPE` Экземпляр `Class`, представляющий примитивный тип `int`.

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

Конструктор и описание
`Integer(int value)` Создает новый объект `Integer`, представляющий указанное значение `int`.
`Integer(String s)` Создает новый объект `Integer`, представляющий значение `int`, указанное параметром `String`.

Методы

Модификатор и тип	Метод и описание
`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(String s)` Парсит строковый аргумент как целое десятичное число со знаком.
`static int`	`parseInt(String s, int radix)` Парсит строковый аргумент как целое число со знаком в указанной системе счисления, заданной вторым аргументом.
`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, -2³¹.

См. также:: Constant Field Values

MAX_VALUE

@Native
public static final int MAX_VALUE

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

См. также:: Constant Field Values

TYPE

public static final Class<Integer> TYPE

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

С версии:: JDK1.1

SIZE

@Native
public static final int SIZE

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

С версии:: 1.5
См. также:: Constant Field Values

BYTES

public static final int BYTES

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

С версии:: 1.8
См. также:: Constant Field Values

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

Integer

public Integer(int value)

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

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

Integer

public Integer(String s)
        throws NumberFormatException

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

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

Методы

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)

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

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

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

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

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

toHexString

public static String toHexString(int i)

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

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

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

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

0123456789abcdef

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

Integer.toHexString(n).toUpperCase()

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

toOctalString

public static String toOctalString(int i)

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

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

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

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

01234567

Это символы от '\u0030' до '\u0037'.

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

toBinaryString

public static String toBinaryString(int i)

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

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

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

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

Параметры:: i - целое число, которое нужно преобразовать в строку.
Возвращает:: строковое представление беззнакового целого значения, представленного аргументом в двоичной системе счисления (система счисления 2).
С версии:: JDK1.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 выбрасывается, если выполняется любое из следующих условий:

Первый аргумент равен null или представляет собой строку нулевой длины.
Основание меньше 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 - если строка не содержит анализируемого целого числа.

parseInt

public static int parseInt(String s)
                    throws NumberFormatException

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

Параметры:: s - строка, содержащая представление целого числа для парсинга
Возвращает:: целое значение, представленное аргументом в десятичной системе.
Инициирует:: 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, 2³²-1.

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

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, содержащий значение, извлечённое из указанной строки, когда она проанализирована с основанием, заданным вторым аргументом. Первый аргумент интерпретируется как представление целого числа со знаком в основании, заданном вторым аргументом, точно так же, как если бы аргументы были переданы в метод 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, содержащий значение указанной строки. Аргумент интерпретируется как представление десятичного целого числа со знаком, точно так же, как если бы аргумент был передан методу 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)

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

Второй аргумент — значение по умолчанию. Возвращается объект 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)

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

Параметры:: x - первое значение целочисленного типа для сравнения; y - второе значение целочисленного типа для сравнения
Возвращает:: значение 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 равное входному значению плюс 2³².

Параметры:: 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)

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

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

lowestOneBit

public static int lowestOneBit(int i)

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

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

numberOfLeadingZeros

public static int numberOfLeadingZeros(int i)

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

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

floor(log₂(x)) = 31 - numberOfLeadingZeros(x)
ceil(log₂(x)) = 32 - numberOfLeadingZeros(x - 1)

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

numberOfTrailingZeros

public static int numberOfTrailingZeros(int i)

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

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

bitCount

public static int bitCount(int i)

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

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

rotateLeft

public static int rotateLeft(int i,
                             int distance)

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

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

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

rotateRight

public static int rotateRight(int i,
                              int distance)

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

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

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

reverse

public static int reverse(int i)

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

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

signum

public static int signum(int i)

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

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

reverseBytes

public static int reverseBytes(int i)

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

Параметры:: i - значение, байты которого необходимо инвертировать
Возвращает:: значение, полученное путём инвертирования байтов в указанном целочисленном значении.
С:: 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)

Возвращает большее из двух целочисленных значений, как если бы вызывали 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.