Класс Long

@Native public static final long MIN_VALUE

См. также:

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

@Native public static final long MAX_VALUE

См. также:

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

public static final Class<Long> TYPE

Начиная с:

1.1

@Native public static final int SIZE

Начиная с:

1.5

См. также:

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

public static final int BYTES

Начиная с:

1.8

См. также:

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

@Deprecated(since="9") public Long(long value)

Параметры:

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

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

Параметры:

s — значение String, которое необходимо преобразовать в Long.

Исключения:

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

public static String toString(long i, int radix)

Параметры:

i — значение long, которое необходимо преобразовать в строку.

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

Возвращает:

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

См. также:

• Character.MAX_RADIX
• Character.MIN_RADIX

public static String toUnsignedString(long i, int radix)

Параметры:

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

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

Возвращает:

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

Начиная с:

1.8

См. также:

• toString(long, int)

public static String toHexString(long i)

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

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

Параметры:

i — значение long, которое необходимо преобразовать в строку.

Возвращает:

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

Начиная с:

1.0.2

См. также:

• HexFormat
• parseUnsignedLong(String, int)
• toUnsignedString(long, int)

public static String toOctalString(long i)

Параметры:

i — значение long, которое необходимо преобразовать в строку.

Возвращает:

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

Начиная с:

1.0.2

См. также:

• parseUnsignedLong(String, int)
• toUnsignedString(long, int)

public static String toBinaryString(long i)

Параметры:

i — значение long, которое необходимо преобразовать в строку.

Возвращает:

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

Начиная с:

1.0.2

См. также:

• parseUnsignedLong(String, int)
• toUnsignedString(long, int)

public static String toString(long i)

Параметры:

i — значение long, которое необходимо преобразовать.

Возвращает:

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

public static String toUnsignedString(long i)

Параметры:

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

Возвращает:

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

Начиная с:

1.8

См. также:

• toUnsignedString(long, int)

public static long parseLong(String s, int radix) throws NumberFormatException

Параметры:

s — строка String, содержащая представление long, которое необходимо разобрать.

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

Возвращает:

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

Исключения:

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

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

Параметры:

s — объект CharSequence, содержащий представление long, которое необходимо разобрать

beginIndex — начальный индекс включительно.

endIndex — конечный индекс исключительно.

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

Возвращает:

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

Исключения:

NullPointerException — если s равно null.

IndexOutOfBoundsException — если beginIndex отрицательно, если beginIndex больше endIndex или если endIndex больше s.length().

NumberFormatException — если CharSequence не содержит разбираемое значение long в указанной системе счисления radix или если radix меньше Character.MIN_RADIX либо больше Character.MAX_RADIX.

Начиная с:

9

public static long parseLong(String s) throws NumberFormatException

Параметры:

s — объект String, содержащий представление long, которое необходимо разобрать

Возвращает:

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

Исключения:

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

public static long parseUnsignedLong(String s, int radix) throws NumberFormatException

Параметры:

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

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

Возвращает:

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

Исключения:

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

Начиная с:

1.8

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

Параметры:

s — объект CharSequence, содержащий представление беззнакового значения long, которое необходимо разобрать

beginIndex — начальный индекс включительно.

endIndex — конечный индекс исключительно.

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

Возвращает:

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

Исключения:

NullPointerException — если s равно null.

IndexOutOfBoundsException — если beginIndex отрицательно, если beginIndex больше endIndex или если endIndex больше s.length().

NumberFormatException — если CharSequence не содержит разбираемое беззнаковое значение long в указанной системе счисления radix или если radix меньше Character.MIN_RADIX либо больше Character.MAX_RADIX.

Начиная с:

9

public static long parseUnsignedLong(String s) throws NumberFormatException

Параметры:

s — объект String, содержащий представление беззнакового значения long, которое необходимо разобрать

Возвращает:

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

Исключения:

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

Начиная с:

1.8

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

Параметры:

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

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

Возвращает:

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

Исключения:

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

public static Long valueOf(String s) throws NumberFormatException

Параметры:

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

Возвращает:

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

Исключения:

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

public static Long valueOf(long l)

Параметры:

l — значение типа long.

Возвращает:

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

Начиная с:

1.5

public static Long decode(String nm) throws NumberFormatException

Параметры:

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

Возвращает:

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

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

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

С версии:

1.2

См. также:

• parseLong(String, int)

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.

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

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

public long longValue()

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

longValue в классе Number

Возвращает:

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

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

Возвращает:

значение хеш-кода этого объекта.

См. также:

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

public static int hashCode(long value)

Параметры:

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

Возвращает:

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

С версии:

1.8

public boolean equals(Object obj)

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

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

• Object.hashCode()
• HashMap

public static Long getLong(String nm)

Параметры:

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

Возвращает:

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

См. также:

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

public static Long getLong(String nm, long val)

Параметры:

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

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

Возвращает:

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

См. также:

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

public static Long getLong(String nm, Long val)

Параметры:

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

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

Возвращает:

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

См. также:

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

public int compareTo(Long anotherLong)

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

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

Параметры:

anotherLong — Long для сравнения.

Возвращает:

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

С версии:

1.2

public static int compare(long x, long y)

   Long.valueOf(x).compareTo(Long.valueOf(y))

Параметры:

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

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

Возвращает:

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

С версии:

1.7

public static int compareUnsigned(long x, long y)

Параметры:

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

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

Возвращает:

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

С версии:

1.8

public static long divideUnsigned(long dividend, long divisor)

Параметры:

dividend — делимое

divisor — делитель

Возвращает:

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

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

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

С версии:

1.8

См. также:

• remainderUnsigned(long, long)

public static long remainderUnsigned(long dividend, long divisor)

Параметры:

dividend — делимое

divisor — делитель

Возвращает:

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

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

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

С версии:

1.8

См. также:

• divideUnsigned(long, long)

public static long highestOneBit(long i)

Параметры:

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

Возвращает:

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

С версии:

1.5

public static long lowestOneBit(long i)

Параметры:

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

Возвращает:

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

С версии:

1.5

public static int numberOfLeadingZeros(long i)

Параметры:

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

Возвращает:

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

С версии:

1.5

public static int numberOfTrailingZeros(long i)

Параметры:

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

Возвращает:

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

С версии:

1.5

public static int bitCount(long i)

Параметры:

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

Возвращает:

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

С версии:

1.5

public static long rotateLeft(long i, int distance)

Параметры:

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

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

Возвращает:

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

С версии:

1.5

public static long rotateRight(long i, int distance)

Параметры:

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

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

Возвращает:

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

С версии:

1.5

public static long reverse(long i)

Параметры:

i — значение для обращения

Возвращает:

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

С версии:

1.5

public static long compress(long i, long mask)

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

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

// Compressing drink to food
compress(0xCAFEBABEL, 0xFF00FFF0L) == 0xCABABL

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

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

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

// Logical shift right
compress(x, -1L << 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 : (1L << 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) можно реализовать следующим образом:

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

long sag(long i, long mask) {
    return compressLeft(i, mask) | Long.compress(i, ~mask);
}

// Separate the sheep from the goats
sag(0x00000000_CAFEBABEL, 0xFFFFFFFF_FF00FFF0L) == 0x00000000_CABABFEEL

Параметры:

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

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

Возвращает:

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

С версии:

19

См. также:

• expand(long, long)

public static long expand(long i, long mask)

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

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

expand(0x0000CABABL, 0xFF00FFF0L) == 0xCA00BAB0L

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

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

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

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

// Expanding all bits returns the mask
expand(-1L, 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 в значении long можно реализовать следующим образом:

long select(long i, long n) {
    // the one-bit in i (the mask) with index n
    long nthBit = Long.expand(1L << n, i);
    // the bit position of the one-bit with index n
    return Long.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(long, long)

public static int signum(long i)

Параметры:

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

Возвращает:

функцию знака для указанного значения long.

С версии:

1.5

public static long reverseBytes(long i)

Параметры:

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

Возвращает:

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

С версии:

1.5

public static long sum(long a, long b)

Параметры:

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

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

Возвращает:

сумму a и b

С версии:

1.8

См. также:

• BinaryOperator

public static long max(long a, long b)

Параметры:

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

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

Возвращает:

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

С версии:

1.8

См. также:

• BinaryOperator

public static long min(long a, long b)

Параметры:

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

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

Возвращает:

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

С версии:

1.8

См. также:

• BinaryOperator

public Optional<Long> describeConstable()

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

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

Возвращает:

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

С версии:

12

public Long resolveConstantDesc(MethodHandles.Lookup lookup)

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

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

Параметры:

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

Возвращает:

экземпляр Long

С версии:

12