Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class Integer extends Number implements Comparable<Integer>
Integer
класс обертывает значение типа примитива int
в объекте. Объект типа Integer
содержит единственное поле, тип которого int
. Кроме того, этот класс обеспечивает несколько методов для того, чтобы они преобразовали int
к a String
и a String
к int
, так же как другие константы и методы, полезные, имея дело с int
.
Примечание реализации: реализации методов "битового жонглирования" (такой как highestOneBit
и numberOfTrailingZeros
) основаны на материале от Генри С. Уоррена, Восхищения Хакера Младшего., (Аддисон Уэсли, 2002).
Модификатор и Тип | Поле и Описание |
---|---|
static int |
MAX_VALUE
Постоянное содержание максимум оценивает
int может иметь, 231-1. |
static int |
MIN_VALUE
Постоянное содержание минимум оценивает
int может иметь,-231. |
static int |
РАЗМЕР
Число битов, используемых, чтобы представить
int значение в дополнительной двоичной форме two. |
static Class<Integer> |
ВВЕСТИ
Class экземпляр, представляющий тип примитива int . |
Конструктор и Описание |
---|
Integer(int value)
Создает недавно выделенный
Integer объект, который представляет указанное int значение. |
Integer(String s)
Создает недавно выделенный
Integer объект, который представляет int значение, обозначенное String параметр. |
Модификатор и Тип | Метод и Описание |
---|---|
static int |
bitCount(int i)
Возвращает число одного бита в дополнительном двоичном представлении two указанного
int значение. |
byte |
byteValue()
Возвращает значение этого
Integer как a byte . |
static int |
compare(int x, int y)
Сравнивается два
int значения в цифровой форме. |
int |
compareTo(Integer anotherInteger)
Сравнивается два
Integer объекты в цифровой форме. |
static Integer |
decode(String nm)
Декодирует a
String в Integer . |
double |
doubleValue()
Возвращает значение этого
Integer как a double . |
boolean |
equals(Object obj)
Сравнивает этот объект с указанным объектом.
|
float |
floatValue()
Возвращает значение этого
Integer как a 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 |
highestOneBit(int i)
Возвраты
int значение с самое большее одноразрядным синглом, в позиции самого высокого порядка ("крайнего левого") одноразрядный в указанном int значение. |
int |
intValue()
Возвращает значение этого
Integer как int . |
long |
longValue()
Возвращает значение этого
Integer как a long . |
static int |
lowestOneBit(int i)
Возвраты
int значение с самое большее одноразрядным синглом, в позиции ("самого правого") одноразрядного самого низкоуровневого в указанном int значение. |
static int |
numberOfLeadingZeros(int i)
Возвращает число нулевых битов, предшествующих самому высокому порядку ("крайнему левому") одноразрядный в дополнительном двоичном представлении two указанного
int значение. |
static int |
numberOfTrailingZeros(int i)
Возвращает число нулевых битов после ("самого правого") одноразрядного самого низкоуровневого в дополнительном двоичном представлении two указанного
int значение. |
static int |
parseInt(String s)
Анализирует строковый параметр как десятичное целое число со знаком.
|
static int |
parseInt(String s, int radix)
Анализирует строковый параметр как целое число со знаком в основании, определенном вторым параметром.
|
static int |
reverse(int i)
Возвращает значение, полученное, инвертируя порядок битов в дополнительном двоичном представлении two указанного
int значение. |
static int |
reverseBytes(int i)
Возвращает значение, полученное, инвертируя порядок байтов в дополнительном представлении two указанного
int значение. |
static int |
rotateLeft(int i, int distance)
Возвращает значение, полученное, поворачивая дополнительное двоичное представление two указанного
int значение уехало конкретным количеством битов. |
static int |
rotateRight(int i, int distance)
Возвращает значение, полученное, поворачивая дополнительное двоичное представление two указанного
int оцените прямо конкретным количеством битов. |
short |
shortValue()
Возвращает значение этого
Integer как a short . |
static int |
signum(int i)
Возвращает сигнум-функцию указанного
int значение. |
static String |
toBinaryString(int i)
Возвращает строковое представление целочисленного параметра как целое без знака в основе 2.
|
static String |
toHexString(int i)
Возвращает строковое представление целочисленного параметра как целое без знака в основе 16.
|
static String |
toOctalString(int i)
Возвращает строковое представление целочисленного параметра как целое без знака в основе 8.
|
Строка |
toString()
Возвраты a
String объект, представляющий это Integer 's значение. |
static String |
toString(int i)
Возвраты a
String объект, представляющий указанное целое число. |
static String |
toString(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 когда анализирующийся с основанием, данным вторым параметром. |
public static final int MIN_VALUE
int
может иметь,-231.public static final int MAX_VALUE
int
может иметь, 231-1.public static final Class<Integer> TYPE
Class
экземпляр, представляющий тип примитива int
.public static final int SIZE
int
значение в дополнительной двоичной форме two.public Integer(int value)
Integer
объект, который представляет указанное int
значение.value
- значение, которое будет представлено Integer
объект.public Integer(String s) throws NumberFormatException
Integer
объект, который представляет int
значение, обозначенное String
параметр. Строка преобразовывается в int
значение точно способом, используемым parseInt
метод для основания 10.s
- String
быть преобразованным в Integer
.NumberFormatException
- если String
не содержит parsable целое число.parseInt(java.lang.String, int)
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
public static String toHexString(int i)
Значение целого без знака является параметром плюс 232, если параметр отрицателен; иначе, это равно параметру. Это значение преобразовывается в строку цифр ASCII в шестнадцатеричном (базируйтесь 16) без дополнительного продвижения 0
s. Если величина без знака является нулем, она представляется единственным нулевым символом '0'
('\u0030'
); иначе, первый символ представления величины без знака не будет нулевым символом. Следующие символы используются в качестве шестнадцатеричных цифр:
0123456789abcdef
Они - символы '\u0030'
через '\u0039'
и '\u0061'
через '\u0066'
. Если прописные буквы требуются, String.toUpperCase()
метод можно вызвать на результате:
Integer.toHexString(n).toUpperCase()
i
- целое число, которое будет преобразовано в строку.public static String toOctalString(int i)
Значение целого без знака является параметром плюс 232, если параметр отрицателен; иначе, это равно параметру. Это значение преобразовывается в строку цифр ASCII в восьмеричном (базируйтесь 8) без дополнительного продвижения 0
s.
Если величина без знака является нулем, она представляется единственным нулевым символом '0'
('\u0030'
); иначе, первый символ представления величины без знака не будет нулевым символом. Следующие символы используются в качестве восьмеричных цифр:
01234567
Они - символы '\u0030'
через '\u0037'
.i
- целое число, которое будет преобразовано в строку.public static String toBinaryString(int i)
Значение целого без знака является параметром плюс 232, если параметр отрицателен; иначе это равно параметру. Это значение преобразовывается в строку цифр ASCII в двоичном файле (базируйтесь 2) без дополнительного продвижения 0
s. Если величина без знака является нулем, она представляется единственным нулевым символом '0'
('\u0030'
); иначе, первый символ представления величины без знака не будет нулевым символом. Символы '0'
('\u0030'
) и '1'
('\u0031'
) используются в качестве двоичных цифр.
i
- целое число, которое будет преобразовано в строку.public static String toString(int i)
String
объект, представляющий указанное целое число. Параметр преобразовывается в десятичное представление со знаком и возвращается как строка, точно как будто параметр и основание 10 были даны как параметры toString(int, int)
метод.i
- целое число, которое будет преобразовано.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
- String
содержа целочисленное представление, которое будет проанализированоradix
- основание, которое будет использоваться, анализируя s
.NumberFormatException
- если String
не содержит parsable int
.public static int parseInt(String s) throws NumberFormatException
'-'
('\u002D'
) указать на отрицательную величину или знак "плюс" ASCII '+'
('\u002B'
) указать на положительное значение. Получающееся целочисленное значение возвращается, точно как будто параметр и основание 10 были даны как параметры parseInt(java.lang.String, int)
метод.s
- a String
содержа int
представление, которое будет проанализированоNumberFormatException
- если строка не содержит parsable целое число.public static Integer valueOf(String s, int radix) throws NumberFormatException
Integer
объект, содержащий значение, извлекается из указанного String
когда анализирующийся с основанием, данным вторым параметром. Первый параметр интерпретируется как представление целого числа со знаком в основании, определенном вторым параметром, точно как будто параметры были даны parseInt(java.lang.String, int)
метод. Результат Integer
объект, который представляет целочисленное значение, определенное строкой. Другими словами этот метод возвращается Integer
возразите равный значению:
new Integer(Integer.parseInt(s, radix))
s
- строка, которая будет проанализирована.radix
- основание, которое будет использоваться в интерпретации s
Integer
объект, содержащий значение, представляется строковым параметром в указанном основании.NumberFormatException
- если String
не содержит parsable int
.public static Integer valueOf(String s) throws NumberFormatException
Integer
объект, содержащий значение указанного String
. Параметр интерпретируется как представление десятичного целого числа со знаком, точно как будто параметр был дан parseInt(java.lang.String)
метод. Результат Integer
объект, который представляет целочисленное значение, определенное строкой. Другими словами этот метод возвращается Integer
возразите равный значению:
new Integer(Integer.parseInt(s))
s
- строка, которая будет проанализирована.Integer
объект, содержащий значение, представляется строковым параметром.NumberFormatException
- если строка не может быть проанализирована как целое число.public static Integer valueOf(int i)
Integer
экземпляр, представляющий указанное int
значение. Если новое Integer
экземпляр не требуется, этот метод должен обычно использоваться в предпочтении к конструктору Integer(int)
, поскольку этот метод, вероятно, приведет к значительно лучшей производительности пространства и времени, кэшируя часто требуемые значения. Этот метод будет всегда кэшировать значения в диапазоне-128 к 127, включительно, и может кэшировать другие значения за пределами этого диапазона.i
- int
значение.Integer
представление экземпляра i
.public byte byteValue()
Integer
как a byte
.public short shortValue()
Integer
как a short
.shortValue
в классе Number
short
.public int intValue()
Integer
как int
.public long longValue()
Integer
как a long
.public float floatValue()
Integer
как a float
.floatValue
в классе Number
float
.public double doubleValue()
Integer
как a double
.doubleValue
в классе Number
double
.public String toString()
String
объект, представляющий это Integer
's значение. Значение преобразовывается в десятичное представление со знаком и возвращается как строка, точно как будто целочисленное значение было дано как параметр toString(int)
метод.public int hashCode()
Integer
.hashCode
в классе Object
int
значение представляется этим Integer
объект.Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
public boolean equals(Object obj)
true
если и только если параметр не null
и Integer
объект, который содержит то же самое int
оцените как этот объект.equals
в классе Object
obj
- объект сравниться с.true
если объекты являются тем же самым; false
иначе.Object.hashCode()
, HashMap
public static Integer getInteger(String nm)
Первый параметр обрабатывается как имя системного свойства. Системные свойства доступны через System.getProperty(java.lang.String)
метод. Строковое значение этого свойства тогда интерпретируется как целочисленное значение и Integer
объект, представляющий это значение, возвращается. Детали возможных числовых форматов могут быть найдены с определением getProperty
.
Если нет никакого свойства с указанным именем, если указанное имя пусто или null
, или если у свойства нет корректного числового формата, то null
возвращается.
Другими словами этот метод возвращается Integer
возразите равный значению:
getInteger(nm, null)
nm
- имя свойства.Integer
значение свойства.System.getProperty(java.lang.String)
, System.getProperty(java.lang.String, java.lang.String)
public static Integer getInteger(String nm, int val)
Первый параметр обрабатывается как имя системного свойства. Системные свойства доступны через System.getProperty(java.lang.String)
метод. Строковое значение этого свойства тогда интерпретируется как целочисленное значение и Integer
объект, представляющий это значение, возвращается. Детали возможных числовых форматов могут быть найдены с определением getProperty
.
Вторым параметром является значение по умолчанию. Integer
объект, который представляет значение второго параметра, возвращается, если нет никакого свойства указанного имени, если у свойства нет корректного числового формата, или если указанное имя пусто или null
.
Другими словами этот метод возвращается Integer
возразите равный значению:
getInteger(nm, new Integer(val))
но практически это может быть реализовано способом, таким как: избегать ненужного выделенияInteger result = getInteger(nm, null); return (result == null) ? new Integer(val) : result;
Integer
возразите, когда значение по умолчанию не необходимо.nm
- имя свойства.val
- значение по умолчанию.Integer
значение свойства.System.getProperty(java.lang.String)
, System.getProperty(java.lang.String, java.lang.String)
public static Integer getInteger(String nm, Integer val)
System.getProperty(java.lang.String)
метод. Строковое значение этого свойства тогда интерпретируется как целочисленное значение, согласно Integer.decode
метод, и Integer
объект, представляющий это значение, возвращается. 0x
или символ ASCII #
, не сопровождаемый знаком "минус", тогда остальная часть этого анализируется как шестнадцатеричное целое число точно как методом valueOf(java.lang.String, int)
с основанием 16. 0
сопровождаемый другим символом, это анализируется как восьмеричное целое число точно как методом valueOf(java.lang.String, int)
с основанием 8. valueOf(java.lang.String, int)
с основанием 10. Вторым параметром является значение по умолчанию. Значение по умолчанию возвращается, если нет никакого свойства указанного имени, если у свойства нет корректного числового формата, или если указанное имя пусто или null
.
nm
- имя свойства.val
- значение по умолчанию.Integer
значение свойства.System.getProperty(java.lang.String)
, System.getProperty(java.lang.String, java.lang.String)
, decode(java.lang.String)
public static Integer decode(String nm) throws NumberFormatException
String
в Integer
. Принимает десятичные, шестнадцатеричные, и восьмеричные числа, данные следующей грамматикой: DecimalNumeral, HexDigits, и OctalDigits как определяются в разделе 3.10.1 из Спецификации языка Java™, за исключением того, что подчеркивания не принимаются между цифрами.
- DecodableString:
- Signopt DecimalNumeral
- Signopt
0x
HexDigits- Signopt
0X
HexDigits- Signopt
#
HexDigits- Signopt
0
OctalDigits
- Знак:
-
+
Последовательность символов после дополнительного знака и/или спецификатора основания ("0x
", "0X
", "#
", или начальный нуль), анализируется как Integer.parseInt
метод с обозначенным основанием (10, 16, или 8). Эта последовательность символов должна представить положительное значение или a NumberFormatException
будет брошен. Результат отрицается если первый символ указанного String
знак "минус". Никакие пробельные символы не разрешаются в String
.
nm
- String
декодировать.Integer
объект, содержащий int
значение, представленное nm
NumberFormatException
- если String
не содержит parsable целое число.parseInt(java.lang.String, int)
public int compareTo(Integer anotherInteger)
Integer
объекты в цифровой форме.compareTo
в интерфейсе Comparable<Integer>
anotherInteger
- Integer
быть сравненным.0
если это Integer
равно параметру Integer
; значение меньше чем 0
если это Integer
в цифровой форме меньше чем параметр Integer
; и значение, больше чем 0
если это Integer
в цифровой форме больше чем параметр Integer
(сравнение со знаком).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
public static int highestOneBit(int i)
int
значение с самое большее одноразрядным синглом, в позиции самого высокого порядка ("крайнего левого") одноразрядный в указанном int
значение. Возвраты обнуляют, если у указанного значения есть никто-биты в дополнительном двоичном представлении его two, то есть, если это равно нулю.int
значение с одноразрядным синглом, в позиции самого высокого порядка, одноразрядного в указанном значении, или нуле, если указанное значение самостоятельно равно нулю.public static int lowestOneBit(int i)
int
значение с самое большее одноразрядным синглом, в позиции ("самого правого") одноразрядного самого низкоуровневого в указанном int
значение. Возвраты обнуляют, если у указанного значения есть никто-биты в дополнительном двоичном представлении его two, то есть, если это равно нулю.int
значение с одноразрядным синглом, в позиции одноразрядного самого низкоуровневого в указанном значении, или нуле, если указанное значение самостоятельно равно нулю.public static int numberOfLeadingZeros(int i)
int
значение. Возвраты 32, если у указанного значения есть никто-биты в дополнительном представлении его two, другими словами если это равно нулю. Отметьте, что этот метод тесно связан с основой логарифма 2. Для всех положительных int
значения x:
31 - numberOfLeadingZeros(x)
32 - numberOfLeadingZeros(x - 1)
int
значение, или 32, если значение равно нулю.public static int numberOfTrailingZeros(int i)
int
значение. Возвраты 32, если у указанного значения есть никто-биты в дополнительном представлении его two, другими словами если это равно нулю.int
значение, или 32, если значение равно нулю.public static int bitCount(int i)
int
значение. Эта функция иногда упоминается как количество совокупности.int
значение.public static int rotateLeft(int i, int distance)
int
значение уехало конкретным количеством битов. (Биты, смещенные из левой руки, или старшего разряда, сторона повторно вступает справа, или младший разряд.) Отметьте, что оставленный вращение с отрицательным расстоянием эквивалентно правильному вращению: rotateLeft(val, -distance) == rotateRight(val, distance)
. Отметьте также, что вращение любым кратным числом 32 не, таким образом, все кроме последних пяти битов расстояния вращения могут быть проигнорированы, даже если расстояние отрицательно: rotateLeft(val, distance) == rotateLeft(val, distance & 0x1F)
.
int
значение уехало конкретным количеством битов.public static int rotateRight(int i, int distance)
int
оцените прямо конкретным количеством битов. (Биты, смещенные из правой руки, или младшего разряда, сторона повторно вступает слева, или старший разряд.) Отметьте, что правильное вращение с отрицательным расстоянием эквивалентно левому вращению: rotateRight(val, -distance) == rotateLeft(val, distance)
. Отметьте также, что вращение любым кратным числом 32 не, таким образом, все кроме последних пяти битов расстояния вращения могут быть проигнорированы, даже если расстояние отрицательно: rotateRight(val, distance) == rotateRight(val, distance & 0x1F)
.
int
оцените прямо конкретным количеством битов.public static int reverse(int i)
int
значение.int
значение.public static int signum(int i)
int
значение. (Возвращаемое значение-1, если указанное значение отрицательно; 0, если указанное значение является нулем; и 1, если указанное значение положительно.)int
значение.public static int reverseBytes(int i)
int
значение.int
значение.
Для дальнейшей ссылки API и документации разработчика, см.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.