Класс Integer

@Native public static final int MIN_VALUE

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

@Native public static final int MAX_VALUE

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

public static final Class<Integer> TYPE

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

@Native public static final int SIZE

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

public static final int BYTES

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

@Deprecated(since="9", forRemoval=true) public Integer(int value)

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

@Deprecated(since="9", forRemoval=true) public Integer(String s) throws NumberFormatException

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

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'. Если основание равно N, то первые N этих символов используются как цифры в radix-N в указанном порядке. Таким образом, цифры для шестнадцатеричного (основание 16) числа – 0123456789abcdef. Если требуются заглавные буквы, можно вызвать метод String.toUpperCase() на результате:

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

public static String toUnsignedString(int i, int radix)

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

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

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

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

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

public static String toHexString(int i)

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

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

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

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

0123456789abcdef

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

Integer.toHexString(n).toUpperCase()

public static String toOctalString(int i)

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

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

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

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

01234567

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

public static String toBinaryString(int i)

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

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

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

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

public static String toString(int i)

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

public static String toUnsignedString(int i)

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

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
 

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

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

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

public static int parseInt(String s) throws NumberFormatException

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

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.
• Представленное строкой значение больше максимального беззнакового целого числа, 2³²-1.

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

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

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

public static int parseUnsignedInt(String s) throws NumberFormatException

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

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))

public static Integer valueOf(String s) throws NumberFormatException

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

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

new Integer(Integer.parseInt(s))

public static Integer valueOf(int i)

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

public byte byteValue()

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

public short shortValue()

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

public int intValue()

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

public long longValue()

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

public float floatValue()

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

public double doubleValue()

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

public String toString()

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

public int hashCode()

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

public static int hashCode(int value)

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

public boolean equals(Object obj)

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

public static Integer getInteger(String nm)

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

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

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

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

getInteger(nm, null)

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 когда значение по умолчанию не требуется.

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.

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 не допускаются.

public int compareTo(Integer anotherInteger)

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

public static int compare(int x, int y)

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

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

public static int compareUnsigned(int x, int y)

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

public static long toUnsignedLong(int x)

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

public static int divideUnsigned(int dividend, int divisor)

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

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

public static int remainderUnsigned(int dividend, int divisor)

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

public static int highestOneBit(int i)

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

public static int lowestOneBit(int i)

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

public static int numberOfLeadingZeros(int i)

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

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

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

public static int numberOfTrailingZeros(int i)

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

public static int bitCount(int i)

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

public static int rotateLeft(int i, int distance)

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

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

public static int rotateRight(int i, int distance)

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

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

public static int reverse(int i)

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

public static int signum(int i)

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

public static int reverseBytes(int i)

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

public static int sum(int a, int b)

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

public static int max(int a, int b)

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

public static int min(int a, int b)

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

public Optional<Integer> describeConstable()

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

public Integer resolveConstantDesc(MethodHandles.Lookup lookup)

Разрешает этот экземпляр как ConstantDesc, результатом чего является сам экземпляр.