Класс Integer

@Native public static final int MIN_VALUE

См. также:

• Значения констант полей

@Native public static final int MAX_VALUE

См. также:

• Значения констант полей

public static final Class<Integer> TYPE

Начиная с:

1.1

@Native public static final int SIZE

Начиная с:

1.5

См. также:

• Значения констант полей

public static final int BYTES

Начиная с:

1.8

См. также:

• Значения констант полей

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

Параметры:

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

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

Параметры:

s — String, которое нужно преобразовать в Integer.

Выбрасывает:

NumberFormatException — если String не содержит целое число, которое можно разобрать.

public static String toString(int i, int radix)

Параметры:

i — целое число, которое нужно преобразовать в строку.

radix — основание системы счисления для строкового представления.

Возвращает:

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

См. также:

• Character.MAX_RADIX
• Character.MIN_RADIX

public static String toUnsignedString(int i, int radix)

Параметры:

i — целое число, которое нужно преобразовать в беззнаковую строку.

radix — основание системы счисления для строкового представления.

Возвращает:

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

Начиная с:

1.8

См. также:

• toString(int, int)

public static String toHexString(int i)

Примечание к API:

Класс HexFormat предоставляет средства форматирования и разбора массивов байтов и примитивных значений, позволяющие получить строку или добавить результат в Appendable. HexFormat форматирует и разбирает шестнадцатеричные символы в верхнем или нижнем регистре, добавляет начальные нули, а для массивов байтов включает разделитель, префикс и суффикс для каждого байта.

Параметры:

i — целое число, которое нужно преобразовать в строку.

Возвращает:

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

Начиная с:

1.0.2

См. также:

• HexFormat
• parseUnsignedInt(String, int)
• toUnsignedString(int, int)

public static String toOctalString(int i)

Параметры:

i — целое число, которое нужно преобразовать в строку.

Возвращает:

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

Начиная с:

1.0.2

См. также:

• parseUnsignedInt(String, int)
• toUnsignedString(int, int)

public static String toBinaryString(int i)

Параметры:

i — целое число, которое нужно преобразовать в строку.

Возвращает:

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

Начиная с:

1.0.2

См. также:

• parseUnsignedInt(String, int)
• toUnsignedString(int, int)

public static String toString(int i)

Параметры:

i — целое число, которое нужно преобразовать.

Возвращает:

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

public static String toUnsignedString(int i)

Параметры:

i — целое число, которое нужно преобразовать в беззнаковую строку.

Возвращает:

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

Начиная с:

1.8

См. также:

• toUnsignedString(int, int)

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

Параметры:

s — String, содержащая представление целого числа, которое нужно разобрать

radix — основание системы счисления, используемое при разборе s.

Возвращает:

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

Выбрасывает:

NumberFormatException — если String не содержит int, которое можно разобрать.

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

Параметры:

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

public static int parseInt(String s) throws NumberFormatException

Параметры:

s — String, содержащее представление int для разбора

Возвращает:

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

Выбрасывает:

NumberFormatException — если строка не содержит целое число, которое можно разобрать.

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

Параметры:

s — String, содержащее беззнаковое представление целого числа для разбора

radix — основание системы счисления, используемое при разборе s.

Возвращает:

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

Выбрасывает:

NumberFormatException — если String не содержит int, которое можно разобрать.

Начиная с:

1.8

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

Параметры:

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

public static int parseUnsignedInt(String s) throws NumberFormatException

Параметры:

s — String, содержащее беззнаковое представление int для разбора

Возвращает:

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

Выбрасывает:

NumberFormatException — если строка не содержит беззнаковое целое число, которое можно разобрать.

Начиная с:

1.8

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

Параметры:

s — строка для разбора.

radix — основание системы счисления для интерпретации s

Возвращает:

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

Выбрасывает:

NumberFormatException — если String не содержит int, которое можно разобрать.

public static Integer valueOf(String s) throws NumberFormatException

Параметры:

s — строка для разбора.

Возвращает:

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

Выбрасывает:

NumberFormatException — если строку нельзя разобрать как целое число.

public static Integer valueOf(int i)

Параметры:

i — значение int.

Возвращает:

экземпляр Integer, представляющий i.

Начиная с:

1.5

public byte byteValue()

Переопределяет:

byteValue в классе Number

Возвращает:

числовое значение, представленное этим объектом после преобразования к типу byte.

См. Спецификацию языка Java:

5.1.3 Сужающее преобразование примитивного типа

public short shortValue()

Переопределяет:

shortValue в классе Number

Возвращает:

числовое значение, представленное этим объектом после преобразования к типу short.

См. Спецификацию языка Java:

5.1.3 Сужающее преобразование примитивного типа

public int intValue()

Определено в:

intValue в классе Number

Возвращает:

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

public long longValue()

Указано в:

longValue в классе Number

Возвращает:

числовое значение, представленное этим объектом, после преобразования к типу long.

См. Спецификацию языка Java:

5.1.2 Расширяющее примитивное преобразование

См. также:

• toUnsignedLong(int)

public float floatValue()

Указано в:

floatValue в классе Number

Возвращает:

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

См. Спецификацию языка Java:

5.1.2 Расширяющее примитивное преобразование

public double doubleValue()

Указано в:

doubleValue в классе Number

Возвращает:

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

См. Спецификацию языка Java:

5.1.2 Расширяющее примитивное преобразование

public String toString()

Переопределяет:

toString в классе Object

Возвращает:

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

public int hashCode()

Переопределяет:

hashCode в классе Object

Возвращает:

значение хеш-кода этого объекта, равное значению примитивного типа int, представленного этим объектом Integer.

См. также:

• Object.equals(java.lang.Object)
• System.identityHashCode(Object)

public static int hashCode(int value)

Параметры:

value — значение, для которого вычисляется хеш-код

Возвращает:

значение хеш-кода для значения int.

Начиная с версии:

1.8

public boolean equals(Object obj)

Переопределяет:

equals в классе Object

Параметры:

obj — объект для сравнения.

Возвращает:

true, если объекты одинаковы; в противном случае — false.

См. также:

• Object.hashCode()
• HashMap

public static Integer getInteger(String nm)

Параметры:

nm — имя свойства.

Возвращает:

значение свойства типа Integer.

См. также:

• System.getProperty(java.lang.String)
• System.getProperty(java.lang.String, java.lang.String)

public static Integer getInteger(String nm, int val)

Параметры:

nm — имя свойства.

val — значение по умолчанию.

Возвращает:

значение свойства типа Integer.

См. также:

• System.getProperty(java.lang.String)
• System.getProperty(java.lang.String, java.lang.String)

public static Integer getInteger(String nm, Integer val)

Параметры:

nm — имя свойства.

val — значение по умолчанию.

Возвращает:

значение свойства типа Integer.

См. также:

• System.getProperty(java.lang.String)
• System.getProperty(java.lang.String, java.lang.String)

public static Integer decode(String nm) throws NumberFormatException

Параметры:

nm — String для декодирования.

Возвращает:

объект Integer, содержащий значение int, представленное nm

Выбрасывает:

NumberFormatException — если String не содержит разбираемое целое число.

См. также:

• parseInt(java.lang.String, int)

public int compareTo(Integer anotherInteger)

Указано в:

compareTo в интерфейсе Comparable<Integer>

Параметры:

anotherInteger — Integer для сравнения.

Возвращает:

значение 0, если этот Integer равен аргументу Integer; значение меньше 0, если этот Integer численно меньше аргумента Integer; и значение больше 0, если этот Integer численно больше аргумента Integer (сравнение со знаком).

Начиная с версии:

1.2

public static int compare(int x, int y)

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

Параметры:

x — первое значение int для сравнения

y — второе значение int для сравнения

Возвращает:

значение 0, если x == y; значение меньше 0, если x < y; и значение больше 0, если x > y

Начиная с версии:

1.7

public static int compareUnsigned(int x, int y)

Параметры:

x — первое значение int для сравнения

y — второе значение int для сравнения

Возвращает:

значение 0, если x == y; значение меньше 0, если x < y как беззнаковые значения; и значение больше 0, если x > y как беззнаковые значения

Начиная с версии:

1.8

public static long toUnsignedLong(int x)

Параметры:

x — значение для преобразования в беззнаковое long

Возвращает:

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

Начиная с версии:

1.8

public static int divideUnsigned(int dividend, int divisor)

Параметры:

dividend — делимое

divisor — делитель

Возвращает:

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

Начиная с версии:

1.8

См. также:

• remainderUnsigned(int, int)

public static int remainderUnsigned(int dividend, int divisor)

Параметры:

dividend — делимое

divisor — делитель

Возвращает:

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

Начиная с версии:

1.8

См. также:

• divideUnsigned(int, int)

public static int highestOneBit(int i)

Параметры:

i — значение, для которого требуется вычислить самый старший бит, равный единице

Возвращает:

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

Начиная с версии:

1.5

public static int lowestOneBit(int i)

Параметры:

i — значение, для которого требуется вычислить самый младший бит, равный единице

Возвращает:

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

Начиная с версии:

1.5

public static int numberOfLeadingZeros(int i)

Параметры:

i — значение, для которого требуется вычислить количество ведущих нулей

Возвращает:

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

Начиная с версии:

1.5

public static int numberOfTrailingZeros(int i)

Параметры:

i — значение, для которого требуется вычислить количество конечных нулей

Возвращает:

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

Начиная с версии:

1.5

public static int bitCount(int i)

Параметры:

i — значение, биты которого требуется подсчитать

Возвращает:

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

Начиная с версии:

1.5

public static int rotateLeft(int i, int distance)

Параметры:

i — значение, биты которого требуется циклически сдвинуть влево

distance — количество битовых позиций для циклического сдвига влево

Возвращает:

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

Начиная с версии:

1.5

public static int rotateRight(int i, int distance)

Параметры:

i — значение, биты которого требуется циклически сдвинуть вправо

distance — количество битовых позиций для циклического сдвига вправо

Возвращает:

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

Начиная с версии:

1.5

public static int reverse(int i)

Параметры:

i — значение для обращения порядка битов

Возвращает:

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

Начиная с версии:

1.5

public static int compress(int i, int mask)

Примечание к API:

Рассмотрим простой случай сжатия цифр шестнадцатеричного значения:

// Compressing drink to food
compress(0xCAFEBABE, 0xFF00FFF0) == 0xCABAB

Начиная с младшей шестнадцатеричной цифры в позиции 0 справа, маска 0xFF00FFF0 выбирает шестнадцатеричные цифры в позициях 1, 2, 3, 6 и 7 значения 0xCAFEBABE. Выбранные цифры последовательно располагаются в результирующем сжатом значении, начиная с позиции 0, в том же порядке.

Следующие тождества возвращают true и помогают понять поведение compress:

// Returns 1 if the bit at position n is one
compress(x, 1 << n) == (x >> n & 1)

// Logical shift right
compress(x, -1 << n) == x >>> n

// Any bits not covered by the mask are ignored
compress(x, m) == compress(x & m, m)

// Compressing a value by itself
compress(m, m) == (m == -1 || m == 0) ? m : (1 << bitCount(m)) - 1

// Expanding then compressing with the same mask
compress(expand(x, m), m) == x & compress(m, m)

Операцию «овцы и козы» (Sheep And Goats, SAG; см. Hacker's Delight, второе издание, раздел 7.7) можно реализовать следующим образом:

int compressLeft(int i, int mask) {
    // This implementation follows the description in Hacker's Delight which
    // is informative. A more optimal implementation is:
    //   Integer.compress(i, mask) << -Integer.bitCount(mask)
    return Integer.reverse(
        Integer.compress(Integer.reverse(i), Integer.reverse(mask)));
}

int sag(int i, int mask) {
    return compressLeft(i, mask) | Integer.compress(i, ~mask);
}

// Separate the sheep from the goats
sag(0xCAFEBABE, 0xFF00FFF0) == 0xCABABFEE

Параметры:

i — значение, биты которого требуется сжать

mask — битовая маска

Возвращает:

сжатое значение

Начиная с версии:

19

См. также:

• expand(int, int)

public static int expand(int i, int mask)

Примечание к API:

Рассмотрим простой случай расширения цифр шестнадцатеричного значения:

expand(0x0000CABAB, 0xFF00FFF0) == 0xCA00BAB0

Начиная с младшей шестнадцатеричной цифры в позиции 0 справа, маска 0xFF00FFF0 выбирает первые пять шестнадцатеричных цифр значения 0x0000CABAB. Выбранные цифры располагаются в результирующем расширенном значении в том же порядке в позициях 1, 2, 3, 6 и 7.

Следующие тождества возвращают true и помогают понять поведение expand:

// Logically shift right the bit at position 0
expand(x, 1 << n) == (x & 1) << n

// Logically shift right
expand(x, -1 << n) == x << n

// Expanding all bits returns the mask
expand(-1, m) == m

// Any bits not covered by the mask are ignored
expand(x, m) == expand(x, m) & m

// Compressing then expanding with the same mask
expand(compress(x, m), m) == x & m

Операцию выбора позиции бита, равного единице, с индексом n в значении int можно реализовать следующим образом:

int select(int i, int n) {
    // the one-bit in i (the mask) with index n
    int nthBit = Integer.expand(1 << n, i);
    // the bit position of the one-bit with index n
    return Integer.numberOfTrailingZeros(nthBit);
}

// The one-bit with index 0 is at bit position 1
select(0b10101010_10101010, 0) == 1
// The one-bit with index 3 is at bit position 7
select(0b10101010_10101010, 3) == 7

Параметры:

i — значение, биты которого требуется расширить

mask — битовая маска

Возвращает:

расширенное значение

Начиная с версии:

19

См. также:

• compress(int, int)

public static int signum(int i)

Параметры:

i — значение, знак которого требуется определить

Возвращает:

знак указанного значения int.

Начиная с версии:

1.5

public static int reverseBytes(int i)

Параметры:

i — значение, байты которого требуется переставить в обратном порядке

Возвращает:

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

Начиная с версии:

1.5

public static int sum(int a, int b)

Параметры:

a — первый операнд

b — второй операнд

Возвращает:

сумму a и b

Начиная с версии:

1.8

См. также:

• BinaryOperator

public static int max(int a, int b)

Параметры:

a — первый операнд

b — второй операнд

Возвращает:

большее из a и b

Начиная с версии:

1.8

См. также:

• BinaryOperator

public static int min(int a, int b)

Параметры:

a — первый операнд

b — второй операнд

Возвращает:

меньшее из a и b

Начиная с версии:

1.8

См. также:

• BinaryOperator

public Optional<Integer> describeConstable()

Определено в:

describeConstable в интерфейсе Constable

Возвращает:

Optional, описывающий экземпляр Integer

Начиная с версии:

12

public Integer resolveConstantDesc(MethodHandles.Lookup lookup)

Определено в:

resolveConstantDesc в интерфейсе ConstantDesc

Параметры:

lookup — игнорируется

Возвращает:

экземпляр Integer

Начиная с версии:

12