Класс 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

Возвращает:

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

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 — делитель

Возвращает:

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

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

ArithmeticException — если делитель равен нулю

С версии:

1.8

См. также:

• remainderUnsigned(int, int)

public static int remainderUnsigned(int dividend, int divisor)

Параметры:

dividend — делимое

divisor — делитель

Возвращает:

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

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

ArithmeticException — если делитель равен нулю

С версии:

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 — значение, для которого нужно вычислить signum

Возвращает:

результат применения функции signum к указанному значению 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