Класс Long

@Native public static final long MIN_VALUE

Постоянная, хранящая минимальное значение, которое может принимать long, -2⁶³.

@Native public static final long MAX_VALUE

Постоянная, хранящая максимальное значение, которое может принимать long, 2⁶³-1.

public static final Class<Long> TYPE

Экземпляр Class, представляющий примитивный тип long.

@Native public static final int SIZE

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

public static final int BYTES

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

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

Создаёт новый объект Long , представляющий указанное значение long.

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

Создаёт новый объект Long , представляющий значение long, указанное параметром String. Строка преобразуется в значение long точно так же, как и метод parseLong для основания 10.

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'. Если используется основание N, то первые N символов используются в качестве цифр в указанном порядке. Например, цифры для шестнадцатеричной системы (основание 16) это 0123456789abcdef. Если требуются прописные буквы, можно вызвать метод String.toUpperCase() на результате:

Long.toString(n, 16).toUpperCase()

public static String toUnsignedString(long i, int radix)

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

Если основание меньше Character.MIN_RADIX или больше Character.MAX_RADIX, то используется основание 10.

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

Если значение равно нулю, оно представляется одиночным символом ноль '0' ('\u0030'); в противном случае, первый символ представления значения не будет символом ноль.

Поведение оснований и символов, используемых в качестве цифр, совпадает с toString.

public static String toHexString(long i)

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

Беззнаковое значение long равно аргументу плюс 2⁶⁴, если аргумент отрицательный; иначе оно равно аргументу. Это значение преобразуется в строку ASCII цифр в шестнадцатеричной системе (основание 16) без дополнительных ведущих 0.

Значение аргумента можно восстановить из возвращаемой строки s, вызвав Long.parseUnsignedLong(s, 16).

Если беззнаковое значение равно нулю, оно представляется одиночным символом ноль '0' ('\u0030'); в противном случае, первый символ представления беззнакового значения не будет символом ноль.

Символы, используемые в качестве шестнадцатеричных цифр:

0123456789abcdef

Это символы от '\u0030' до '\u0039' и от '\u0061' до '\u0066'. Если требуются прописные буквы, можно вызвать метод String.toUpperCase() на результате:

Long.toHexString(n).toUpperCase()

public static String toOctalString(long i)

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

Беззнаковое long значение равно аргументу плюс 2⁶⁴, если аргумент отрицательный; в противном случае оно равно аргументу. Это значение преобразуется в строку ASCII-цифр в восьмеричной системе счисления (основание 8) без дополнительных ведущих 0.

Значение аргумента может быть восстановлено из возвращаемой строки s, вызвав Long.parseUnsignedLong(s, 8).

Если беззнаковое значение равно нулю, оно представляется одной цифрой ноль '0' ('\u0030'); в противном случае первая цифра представления беззнакового значения не будет нулём. В качестве восьмеричных цифр используются следующие символы:

01234567

Эти символы от '\u0030' до '\u0037'.

public static String toBinaryString(long i)

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

Беззнаковое long значение равно аргументу плюс 2⁶⁴, если аргумент отрицательный; в противном случае оно равно аргументу. Это значение преобразуется в строку ASCII-цифр в двоичной системе счисления (основание 2) без дополнительных ведущих 0.

Значение аргумента может быть восстановлено из возвращаемой строки s вызвав Long.parseUnsignedLong(s, 2).

Если беззнаковое значение равно нулю, оно представляется одной цифрой ноль '0' ('\u0030'); в противном случае первая цифра представления беззнакового значения не будет нулём. Символы '0' ('\u0030') и '1' ('\u0031') используются в качестве двоичных цифр.

public static String toString(long i)

Возвращает объект String представляющий указанное long. Аргумент преобразуется в знаковое десятичное представление и возвращается в виде строки, точно так же, как если бы аргумент и основание 10 были переданы в метод toString(long, int).

public static String toUnsignedString(long i)

Возвращает строковое представление аргумента как беззнаковое десятичное значение. Аргумент преобразуется в беззнаковое десятичное представление и возвращается в виде строки, точно так же, как если бы аргумент и основание 10 были переданы в метод toUnsignedString(long, int).

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 или является строкой длины ноль.
• Основание меньше 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
 

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

Парсит аргумент CharSequence как знаковое long в указанной системе radix, начиная с указанного beginIndex и до endIndex - 1.

Метод не предпринимает мер для защиты от изменения CharSequence во время парсинга.

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.

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

Парсит строковый аргумент как беззнаковое целое число в указанном основание по второму аргументу. Беззнаковое целое число отображает значения, обычно связанные с отрицательными числами, на положительные числа, большие чем MAX_VALUE. Символы в строке должны быть цифрами указанного основания (как определено тем, возвращает ли Character.digit(char, int) ненулевое значение), за исключением того, что первый символ может быть ASCII плюс знаком '+' ('\u002B'). Возвращается полученное целое значение.

Исключение типа NumberFormatException выбрасывается, если происходит любой из следующих случаев:

• Первый аргумент — null или строка нулевой длины.
• Основание меньше Character.MIN_RADIX или больше Character.MAX_RADIX.
• Любой символ строки не является цифрой заданного основания, за исключением первого символа, который может быть знаком плюс '+' ('\u002B') при условии, что длина строки больше 1.
• Представленное в строке значение больше наибольшего беззнакового целого числа, 2⁶⁴-1.

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

Парсит аргумент CharSequence как беззнаковое целое число в заданном radix, начиная с указанного beginIndex и до endIndex - 1.

Метод не предпринимает мер для защиты от изменения CharSequence во время парсинга.

public static long parseUnsignedLong(String s) throws NumberFormatException

Парсит строковый аргумент как беззнаковое десятичное целое число. Символы в строке должны быть десятичными цифрами, за исключением того, что первый символ может быть ASCII знаком плюс '+' ('\u002B'). Полученное целое значение возвращается точно так же, как если бы аргумент и основание 10 были переданы в метод parseUnsignedLong(java.lang.String, int).

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

Возвращает объект типа Long, содержащий значение, полученное из указанной String при парсинге с основанием, заданным вторым аргументом. Первый аргумент интерпретируется как представляющий знаковое целое число в основании, заданном вторым аргументом, точно так же, как если бы аргументы были переданы методу parseLong(java.lang.String, int). Результатом является объект типа Long , представляющий значение long , заданное в строке.

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

Long.valueOf(Long.parseLong(s, radix))

public static Long valueOf(String s) throws NumberFormatException

Возвращает объект типа Long, содержащий значение указанной String. Аргумент интерпретируется как представляющий знаковое десятичное целое число, точно так же, как если бы аргумент был передан методу parseLong(java.lang.String). Результатом является объект типа Long , представляющий целое значение, заданное в строке.

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

Long.valueOf(Long.parseLong(s))

public static Long valueOf(long l)

Возвращает экземпляр типа Long , представляющий заданное значение long. Если новый экземпляр Long не требуется, этот метод следует предпочитать конструктору Long(long), так как он, вероятно, обеспечит значительно лучшую производительность в плане памяти и времени, кэшируя часто запрашиваемые значения. Этот метод всегда будет кэшировать значения в диапазоне от -128 до 127 включительно и может кэшировать другие значения за пределами этого диапазона.

public static Long decode(String nm) throws NumberFormatException

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

ДекодируемаяСтрока:

Знак_опц ДесятичноеЧисло

Знак_опц 0x ШестнадцатеричныеЦифры

Знак_опц 0X ШестнадцатеричныеЦифры

Знак_опц # ШестнадцатеричныеЦифры

Знак_опц 0 ВосьмеричныеЦифры

Знак:

-

+

ДесятичноеЧисло, ШестнадцатеричныеЦифры и ВосьмеричныеЦифры определены в разделе 3.10.1 спецификации языка Java, за исключением того, что подчёркивания между цифрами не допускаются.

Последовательность символов после необязательного знака и/или спецификатора основания ("0x", "0X", "#" или ведущий ноль) парсится методом Long.parseLong с указанным основанием (10, 16 или 8). Эта последовательность символов должна представлять положительное значение, иначе будет выброшено исключение NumberFormatException. Результат умножается на -1, если первый символ указанной String является знаком минус. В String не допускаются пробелы.

public byte byteValue()

Возвращает значение этого целого числа как байт после сужения примитивного типа.

public short shortValue()

Возвращает значение этого Long в виде short после преобразования сужающего примитива.

public int intValue()

Возвращает значение этого Long как int после преобразования сужающего примитива.

public long longValue()

Возвращает значение этого Long как значение long.

public float floatValue()

Возвращает значение этого Long как float после преобразования расширяющего примитива.

public double doubleValue()

Возвращает значение этого Long как double после преобразования расширяющего примитива.

public String toString()

Возвращает объект String, представляющий значение этого Long. Значение преобразуется в знаковое десятичное представление и возвращается в виде строки, точно так же, как если бы значение long было передано в качестве аргумента методу toString(long).

public int hashCode()

Возвращает код хэширования для этого Long. Результатом является исключающее ИЛИ двух половин значения примитива long, хранящегося в этом объекте Long . То есть, хэш-код равен значению выражения:

(int)(this.longValue()^(this.longValue()>>>32))

public static int hashCode(long value)

Возвращает хэш-код для значения long; совместимо с Long.hashCode().

public boolean equals(Object obj)

Сравнивает этот объект с указанным объектом. Результатом является true тогда и только тогда, когда аргумент не null и является объектом Long , содержащим то же значение long , что и этот объект.

public static Long getLong(String nm)

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

Первый аргумент обрабатывается как имя системной переменной. Доступ к системным переменным осуществляется через метод System.getProperty(java.lang.String). Строковое значение этой переменной затем интерпретируется как значение long с использованием грамматики, поддерживаемой decode, и возвращается объект Long , представляющий это значение.

Если переменной с указанным именем нет, если указанное имя пустое или null, или если переменная не имеет правильного числового формата, то возвращается null .

Другими словами, этот метод возвращает объект Long , равный значению:

getLong(nm, null)

public static Long getLong(String nm, long val)

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

Первый аргумент обрабатывается как имя системной переменной. Доступ к системным переменным осуществляется через метод System.getProperty(java.lang.String). Строковое значение этой переменной затем интерпретируется как значение long с использованием грамматики, поддерживаемой decode, и возвращается объект Long , представляющий это значение.

Второй аргумент — значение по умолчанию. Объект Long , представляющий значение второго аргумента, возвращается, если переменной с указанным именем нет, если переменная не имеет правильного числового формата или если указанное имя пустое или null.

Другими словами, этот метод возвращает объект Long , равный значению:

getLong(nm, Long.valueOf(val))

но на практике он может быть реализован таким образом:

 Long result = getLong(nm, null);
 return (result == null) ? Long.valueOf(val) : result;
 

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

public static Long getLong(String nm, Long val)

Возвращает значение системной переменной с заданным именем. Первый аргумент рассматривается как имя системной переменной. Системные переменные доступны через метод System.getProperty(java.lang.String). Строковое значение этой переменной затем интерпретируется как целочисленное значение, согласно методу decode, и возвращается объект Long, представляющий это значение; в кратце:

• Если значение переменной начинается с двух ASCII символов 0x или ASCII символа #, не следующих за знаком минус, то остальная часть анализируется как шестнадцатеричное целое число точно так же, как для метода valueOf(java.lang.String, int) с основанием 16.
• Если значение переменной начинается с ASCII символа 0, за которым следует другой символ, то оно анализируется как восьмеричное целое число точно так же, как методом valueOf(java.lang.String, int) с основанием 8.
• В противном случае значение переменной анализируется как десятичное целое число точно так же, как методом valueOf(java.lang.String, int) с основанием 10.

Обратите внимание, что в каждом случае ни L ('\u004C') ни l ('\u006C') не разрешается появляться в конце значения переменной в качестве указателя типа, как это было бы разрешено в исходном коде языка программирования Java.

Второй аргумент — это значение по умолчанию. Значение по умолчанию возвращается, если нет переменной с указанным именем, если переменная не имеет правильного числового формата, или если указанное имя пустое или null.

public int compareTo(Long anotherLong)

Сравнивает два объекта Long численно.

public static int compare(long x, long y)

Сравнивает два значения long численно. Возвращаемое значение идентично тому, что было бы возвращено:

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

public static int compareUnsigned(long x, long y)

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

public static long divideUnsigned(long dividend, long divisor)

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

Обратите внимание, что в арифметике со знаком минус три другие основные арифметические операции сложения, вычитания и умножения поразрядны одинаковы, если оба операнда рассматриваются как со знаком или без знака. Поэтому отдельные методы addUnsigned, и т. д., не предоставляются.

public static long remainderUnsigned(long dividend, long divisor)

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

public static long highestOneBit(long i)

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

public static long lowestOneBit(long i)

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

public static int numberOfLeadingZeros(long i)

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

Обратите внимание, что этот метод тесно связан с логарифмом по основанию 2. Для всех положительных значений long x:

• floor(log₂(x)) = 63 - numberOfLeadingZeros(x)
• ceil(log₂(x)) = 64 - numberOfLeadingZeros(x - 1)

public static int numberOfTrailingZeros(long i)

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

public static int bitCount(long i)

Возвращает количество единичных битов в двоичном представлении со знаком минус заданного значения long. Эта функция иногда называется счётом популяции.

public static long rotateLeft(long i, int distance)

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

Обратите внимание, что циклический сдвиг влево с отрицательным значением расстояния эквивалентен циклическому сдвигу вправо: rotateLeft(val, -distance) == rotateRight(val, distance). Также обратите внимание, что сдвиг на любое кратное 64 — это пустая операция, поэтому все, кроме последних шести разрядов, расстояния сдвига можно игнорировать, даже если расстояние отрицательное: rotateLeft(val, distance) == rotateLeft(val, distance & 0x3F).

public static long rotateRight(long i, int distance)

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

Обратите внимание, что циклический сдвиг вправо с отрицательным значением расстояния эквивалентен циклическому сдвигу влево: rotateRight(val, -distance) == rotateLeft(val, distance). Также обратите внимание, что сдвиг на любое кратное 64 — это пустая операция, поэтому все, кроме последних шести разрядов, расстояния сдвига можно игнорировать, даже если расстояние отрицательное: rotateRight(val, distance) == rotateRight(val, distance & 0x3F).

public static long reverse(long i)

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

public static long compress(long i, long mask)

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

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

public static long expand(long i, long mask)

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

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

public static int signum(long i)

Возвращает функцию signum для заданного long значения. (Возвращаемое значение равно -1, если заданное значение отрицательное; 0, если заданное значение равно нулю; и 1, если заданное значение положительное.)

public static long reverseBytes(long i)

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

public static long sum(long a, long b)

Складывает два long значения, как при использовании оператора +.

public static long max(long a, long b)

Возвращает большее из двух long значений, как будто вызывается Math.max.

public static long min(long a, long b)

Возвращает меньшее из двух long значений, как будто вызывается Math.min.

public Optional<Long> describeConstable()

Возвращает Optional, содержащий номинальный дескриптор для этого экземпляра, который является самим экземпляром.

public Long resolveConstantDesc(MethodHandles.Lookup lookup)

Решает этот экземпляр как ConstantDesc, результатом чего является сам экземпляр.