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