Spec-Zone .ru
спецификации, руководства, описания, API
Содержание | Предыдущий | Следующий | Индекс

20.8 Класс java.lang.Long

public final class Long extends Number {
	public static final long MIN_VALUE = 0x8000000000000000L;
	public static final long MAX_VALUE = 0x7fffffffffffffffL;
	public Long(long value);
	public Long(String s)
throws NumberFormatException; public String toString(); public boolean equals(Object obj); public int hashCode(); public int intValue(); public long longValue(); public float floatValue(); public double doubleValue(); public static String toString(long i); public static String toString(long i, int radix); public static String toHexString(long i); public static String toOctalString(long i); public static String toBinaryString(long i); public static long parseLong(String s)
throws NumberFormatException; public static long parseLong(String s, int radix)
throws NumberFormatException; public static Long valueOf(String s)
throws NumberFormatException; public static Long valueOf(String s, int radix)
throws NumberFormatException; public static Long getLong(String nm); public static Long getLong(String nm, long val); public static Long getLong(String nm, Long val); }

20.8.1 public static final long MIN_VALUE = 0x8000000000000000L;

Постоянная величина этого поля является самым низким значением типа long.

20.8.2 public static final long MAX_VALUE = 0x7fffffffffffffffL;

Постоянная величина этого поля является самым высоким значением типа long.

20.8.3 public Long(long value)

Этот конструктор инициализирует недавно создаваемый Long возразите так, чтобы это представило примитивное значение, которое является параметром.

20.8.4 public Long(String s) throws NumberFormatException

Этот конструктор инициализирует недавно создаваемый Long возразите так, чтобы это представило целое число, представленное строкой в десятичной форме. Строка преобразовывается в a long значение точно способом, используемым parseLong метод (§20.8.17) для основания 10.

20.8.5 public String toString()

long целочисленное значение представляется этим Long объект преобразовывается в десятичное представление со знаком и возвращается как строка, точно как будто целочисленное значение было дано как параметр toString метод, который берет один параметр (§20.7.12).

Переопределения toString метод Object (§20.1.2).

20.8.6 public boolean equals(Object obj)

Результат true если и только если параметр не null и a Long объект, который представляет то же самое long оцените как это Long объект.

Переопределения equals метод Object (§20.1.3).

20.8.7 public int hashCode()

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

(int)(this.longValue()^(this.longValue()>>>32))
Переопределения hashCode метод Object (§20.1.4).

20.8.8 public int intValue()

long значение представляется этим Long объект преобразовывается (§5.1.3), чтобы ввести int и результат преобразования возвращается.

Переопределения intValue метод Number (§20.6.1).

20.8.9 public long longValue()

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

Переопределения longValue метод Number (§20.6.2).

20.8.10 public float floatValue()

long значение представляется этим Long объект преобразовывается (§5.1.2), чтобы ввести float и результат преобразования возвращается.

Переопределения floatValue метод Number (§20.6.3).

20.8.11 public double doubleValue()

long значение представляется этим Long объект преобразовывается (§5.1.2), чтобы ввести double и результат преобразования возвращается.

Переопределения doubleValue метод Number (§20.6.4).

20.8.12 public static String toString(long i)

Параметр преобразовывается в десятичное представление со знаком и возвращается как строка, точно как будто параметр и основание 10 были даны как параметры toString метод, который берет два параметра (§20.8.13).

20.8.13 public static String toString(long i, int radix)

Первый параметр преобразовывается в представление со знаком в основании, определенном вторым параметром; это представление возвращается как строка.

Если radix меньше чем Character.MIN_RADIX (§20.5.3) или больше чем Character.MAX_RADIX (§20.5.4), тогда значение 10 используется вместо этого.

Если первый параметр будет отрицателен, то первый символ результата будет символом '-' ('\u002d'). Если первый параметр не отрицателен, никакой символ знака не появляется в результате.

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

0123456789abcdefghijklmnopqrstuvwxyz
Они '\u0030' через '\u0039' и '\u0061' через '\u007a'. Если radix N, тогда первые N этих символов используются в качестве цифр основания-N в показанном порядке. Таким образом цифры для шестнадцатеричного (основание 16) 0123456789abcdef. Если прописные буквы требуются, toUpperCase метод (§20.12.36) класса String может быть вызван на результате:

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

20.8.14 public static String toHexString(long i)

Параметр преобразовывается в представление без знака в шестнадцатеричном основании (базируйтесь 16); это представление возвращается как строка.

Результат представляет величину без знака параметра. Это равняется параметру плюс то, если параметр отрицателен; иначе, это равняется параметру.

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

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

Long.toHexString(n).toUpperCase()

20.8.15 public static String toOctalString(long i)

Параметр преобразовывается в представление без знака в восьмеричном основании (базируйтесь 8); это представление возвращается как строка.

Результат представляет величину без знака параметра. Это равняется параметру плюс то, если параметр отрицателен; иначе, это равняется параметру.

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

01234567
Они - символы '\u0030' через '\u0037'.

20.8.16 public static String toBinaryString(long i)

Параметр преобразовывается в представление без знака в двоичном основании (базируйтесь 2); это представление возвращается как строка.

Результат представляет величину без знака параметра. Это равняется параметру плюс то, если параметр отрицателен; иначе, это равняется параметру.

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

20.8.17 public static long parseLong(String s)
throws NumberFormatException

Параметр интерпретируется как представление десятичного целого числа со знаком. Компоненты строки должны все быть десятичными цифрами, за исключением того, что первый символ может быть '-' ('\u002d') указать на отрицательную величину. Получающееся long значение возвращается, точно как будто параметр и основание 10 были даны как параметры parseLong метод, который берет два параметра (§20.8.18).

Не отметьте это ни один L ни l разрешается появиться в конце строки как индикатор типа, как был бы разрешен в исходном коде Java (§3.10.1).

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

Первый параметр интерпретируется как представление целого числа со знаком в основании, определенном вторым параметром. Компоненты строки должны все быть цифрами указанного основания (как определено, ли Character.digit (§20.5.23) возвращает неотрицательное значение), за исключением того, что первый символ может быть '-' ('\u002d') указать на отрицательную величину. Получающееся long значение возвращается.

Не отметьте это ни один L ни l разрешается появиться в конце строки как индикатор типа, как был бы разрешен в исходном коде Java (§3.10.1) - за исключением того, что также L или l может появиться как цифра для основания, больше чем 22.

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

Примеры:


parseLong("0", 10) returns 0L
parseLong("473", 10) returns 473L
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

20.8.19 public static Long valueOf(String s)
throws NumberFormatException

Параметр интерпретируется как представление десятичного целого числа со знаком, точно как будто параметр был дан parseLong метод, который берет один параметр (§20.8.17). Результатом является a Long объект, который представляет целочисленное значение, определенное строкой.

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

new Long(Long.parseLong(s))

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

Первый параметр интерпретируется как представление целого числа со знаком в основании, определенном вторым параметром, точно как будто параметры были даны parseLong метод, который берет два параметра (§20.8.18). Результатом является a Long объект, который представляет целочисленное значение, определенное строкой.

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

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

20.8.21 public static Long getLong(String nm)

Первый параметр обрабатывается как имя системного свойства, которое будет получено как будто методом System.getProperty (§20.18.9). Строковое значение этого свойства тогда интерпретируется как целочисленное значение и a Long объект, представляющий это значение, возвращается. Если нет никакого свойства указанного имени, или если у свойства нет корректного числового формата, то null возвращается.

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

getLong(nm, null)

20.8.22 public static Long getLong(String nm, long val)

Первый параметр обрабатывается как имя системного свойства, которое будет получено как будто методом System.getProperty (§20.18.9). Строковое значение этого свойства тогда интерпретируется как целочисленное значение и a Long объект, представляющий это значение, возвращается. Если нет никакого свойства указанного имени, или если у свойства нет корректного числового формата, то a Long объект, который представляет значение второго параметра, возвращается.

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

getLong(nm, new Long(val))
но практически это может быть реализовано способом, таким как:


Long result = getLong(nm, null);
return (result == null) ? new Long(val) : result;
избегать ненужного выделения a Long возразите, когда значение по умолчанию не необходимо.

20.8.23 public static Long getLong(String nm, Long val)

Первый параметр обрабатывается как имя системного свойства, которое будет получено как будто методом System.getProperty (§20.18.9). Строковое значение этого свойства тогда интерпретируется как целочисленное значение и a Long объект, представляющий это значение, возвращается.

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

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


Содержание | Предыдущий | Следующий | Индекс

Спецификация языка Java (HTML, сгенерированный Блинчиком "сюзет" Pelouch 24 февраля 1998)
Авторское право © Sun Microsystems, Inc 1996 года. Все права защищены
Пожалуйста, отправьте любые комментарии или исправления к doug.kramer@sun.com

free hit counter