|
Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class Float extends Number implements Comparable<Float>
Float class обертывает значение типа примитива float в объекте. Объект типа Float содержит единственное поле, тип которого float. Кроме того, этот class обеспечивает несколько методов для того, чтобы они преобразовали a float к a String и a String к a float, так же как другие константы и методы, полезные, имея дело с a float.
| Модификатор и Тип | Поле и Описание |
|---|---|
static int |
БАЙТЫ
Число байтов, используемых, чтобы представить a
float значение. |
static int |
MAX_EXPONENT
Максимальная экспонента конечное
float переменная может иметь. |
static float |
MAX_VALUE
Постоянное содержание самое большое положительное конечное значение типа
float, (2-2-23)·2127. |
static int |
MIN_EXPONENT
Минимальная экспонента нормализованный
float переменная может иметь. |
static float |
MIN_NORMAL
Постоянное содержание самое маленькое положительное нормальное значение типа
float, 2-126. |
static float |
MIN_VALUE
Постоянное содержание самое маленькое положительное ненулевое значение типа
float, 2-149. |
static float |
НЭН
Постоянное содержание Не-число (НЭН) значение типа
float. |
static float |
NEGATIVE_INFINITY
Постоянное содержание отрицательная бесконечность типа
float. |
static float |
POSITIVE_INFINITY
Постоянное содержание положительная бесконечность типа
float. |
static int |
РАЗМЕР
Число битов, используемых, чтобы представить a
float значение. |
static Class<Float> |
ВВЕСТИ
Class экземпляр, представляющий тип примитива float. |
| Конструктор и Описание |
|---|
Float(double value)
Создает недавно выделенный
Float объект, который представляет параметр, преобразованный в тип float. |
Float(float value)
Создает недавно выделенный
Float объект, который представляет примитив float параметр. |
Float(String s)
Создает недавно выделенный
Float объект, который представляет значение с плавающей точкой типа float представленный строкой. |
| Модификатор и Тип | Метод и Описание |
|---|---|
byte |
byteValue()
Возвращает значение этого
Float как a byte после сужающегося примитивного преобразования. |
static int |
compare(float f1, float f2)
Сравнивает эти определенные два
float значения. |
int |
compareTo(Float anotherFloat)
Сравнивается два
Float объекты в цифровой форме. |
double |
doubleValue()
Возвращает значение этого
Float как a double после расширяющегося примитивного преобразования. |
boolean |
equals(Object obj)
Сравнивает этот объект с указанным объектом.
|
static int |
floatToIntBits(float value)
Возвращает представление указанного значения с плавающей точкой согласно IEEE 754 "единственный формат с плавающей точкой" разрядное расположение.
|
static int |
floatToRawIntBits(float value)
Возвращает представление указанного значения с плавающей точкой согласно IEEE 754 "единственный формат с плавающей точкой" разрядное расположение, сохраняя Не-число (НЭН) значения.
|
float |
floatValue()
Возвраты
float значение этого Float объект. |
int |
hashCode()
Возвращает хэш-код для этого
Float объект. |
static int |
hashCode(float value)
Возвращает хэш-код для a
float значение; совместимый с Float.hashCode(). |
static float |
intBitsToFloat(int bits)
Возвраты
float значение, соответствующее данному разрядному представлению. |
int |
intValue()
Возвращает значение этого
Float как int после сужающегося примитивного преобразования. |
static boolean |
isFinite(float f)
Возвраты
true если параметром является конечное значение с плавающей точкой; возвраты false иначе (для НЭН и параметров бесконечности). |
boolean |
isInfinite()
Возвраты
true если это Float значение является бесконечно большим в величине, false иначе. |
static boolean |
isInfinite(float v)
Возвраты
true если конкретное количество является бесконечно большим в величине, false иначе. |
boolean |
isNaN()
Возвраты
true если это Float значение является Не-числом (НЭН), false иначе. |
static boolean |
isNaN(float v)
Возвраты
true если конкретное количество является Не-числом (НЭН) значение, false иначе. |
long |
longValue()
Значение возвратов этого
Float как a long после сужающегося примитивного преобразования. |
static float |
max(float a, float b)
Возвращает большие из два
float значения, как будто, вызывая Math.max. |
static float |
min(float a, float b)
Возвращает меньшие из два
float значения, как будто, вызывая Math.min. |
static float |
parseFloat(String s)
Возвращает новое
float инициализированный к значению представляется указанным String, как выполняющийся valueOf метод class Float. |
short |
shortValue()
Возвращает значение этого
Float как a short после сужающегося примитивного преобразования. |
static float |
sum(float a, float b)
Добавляет два
float значения вместе согласно + оператор. |
static String |
toHexString(float f)
Возвращает шестнадцатеричное строковое представление
float параметр. |
Строка |
toString()
Возвращает строковое представление этого
Float объект. |
static String |
toString(float f)
Возвращает строковое представление
float параметр. |
static Float |
valueOf(float f)
Возвраты a
Float экземпляр, представляющий указанное float значение. |
static Float |
valueOf(String s)
Возвраты a
Float объект, содержащий float значение представляется строкой параметра s. |
public static final float POSITIVE_INFINITY
float. Это равно значению, возвращенному Float.intBitsToFloat(0x7f800000).public static final float NEGATIVE_INFINITY
float. Это равно значению, возвращенному Float.intBitsToFloat(0xff800000).public static final float NaN
float. Это эквивалентно значению, возвращенному Float.intBitsToFloat(0x7fc00000).public static final float MAX_VALUE
float, (2-2-23) · 2127. Это равно шестнадцатеричному литералу с плавающей точкой 0x1.fffffeP+127f и также равный Float.intBitsToFloat(0x7f7fffff).public static final float MIN_NORMAL
float, 2-126. Это равно шестнадцатеричному литералу с плавающей точкой 0x1.0p-126f и также равный Float.intBitsToFloat(0x00800000).public static final float MIN_VALUE
float, 2-149. Это равно шестнадцатеричному литералу с плавающей точкой 0x0.000002P-126f и также равный Float.intBitsToFloat(0x1).public static final int MAX_EXPONENT
float переменная может иметь. Это равно значению, возвращенному Math.getExponent(Float.MAX_VALUE).public static final int MIN_EXPONENT
float переменная может иметь. Это равно значению, возвращенному Math.getExponent(Float.MIN_NORMAL).public static final int SIZE
float значение.public static final int BYTES
float значение.public Float(float value)
Float объект, который представляет примитив float параметр.value - значение, которое будет представлено Float.public Float(double value)
Float объект, который представляет параметр, преобразованный в тип float.value - значение, которое будет представлено Float.public Float(String s) throws NumberFormatException
Float объект, который представляет значение с плавающей точкой типа float представленный строкой. Строка преобразовывается в a float оцените как будто valueOf метод.s - строка, которая будет преобразована в a Float.NumberFormatException - если строка не содержит parsable число.valueOf(java.lang.String)public static String toString(float f)
float параметр. Все символы, упомянутые ниже, являются символами ASCII. NaN". -' ('\u002D'); если знак положителен, никакой символ знака не появляется в результате. Что касается величины м.: "Infinity"; таким образом положительная бесконечность приводит к результату "Infinity" и отрицательная бесконечность приводит к результату "-Infinity". "0.0"; таким образом отрицательный нуль приводит к результату "-0.0" и положительный нуль приводит к результату "0.0". .' ('\u002E'), сопровождаемый одной или более десятичными цифрами, представляющими дробную часть м. .' ('\u002E'), сопровождаемый десятичными цифрами, представляющими дробную часть a, сопровождаемого буквой'E' ('\u0045'), сопровождаемый представлением n как десятичное целое число, как произведено методом Integer.toString(int). float. Таким образом, предположите, что x является точным математическим значением, представленным десятичным представлением, произведенным этим методом для конечного ненулевого параметра f. Затем f должен быть float оцените самый близкий x; или, если два float значения одинаково близко к x, тогда f должен быть одним из них, и младший значащий бит мантиссы f должен быть 0. Чтобы создать локализованные строковые представления значения с плавающей точкой, используйте подклассы NumberFormat.
f - плавание, которое будет преобразовано.public static String toHexString(float f)
float параметр. Все символы, упомянутые ниже, являются символами ASCII. NaN". -' ('\u002D'); если знак положителен, никакой символ знака не появляется в результате. Что касается величины м.: "Infinity"; таким образом положительная бесконечность приводит к результату "Infinity" и отрицательная бесконечность приводит к результату "-Infinity". "0x0.0p0"; таким образом отрицательный нуль приводит к результату "-0x0.0p0" и положительный нуль приводит к результату "0x0.0p0". float значение с нормализованным представлением, подстроки используются, чтобы представить поля экспоненты и мантисса. Мантисса представляется символами "0x1." сопровождаемый строчным шестнадцатеричным представлением остальной части мантиссы как часть. Конечные нули в шестнадцатеричном представлении удаляются, если все цифры не являются нулем, когда используется единственный нуль. Затем, экспонента представляется "p" сопровождаемый десятичной строкой несмещенной экспоненты, как будто произведенный звонком Integer.toString на значении экспоненты. float значение с субнормальным представлением, мантисса представляется символами "0x0." сопровождаемый шестнадцатеричным представлением остальной части мантиссы как часть. Конечные нули в шестнадцатеричном представлении удаляются. Затем, экспонента представляется "p-126". Отметьте, что должна быть по крайней мере одна ненулевая цифра в субнормальной мантиссе. | Значение с плавающей точкой | Шестнадцатеричная Строка |
|---|---|
1.0 | 0x1.0p0 |
-1.0 | -0x1.0p0 |
2.0 | 0x1.0p1 |
3.0 | 0x1.8p1 |
0.5 | 0x1.0p-1 |
0.25 | 0x1.0p-2 |
Float.MAX_VALUE |
0x1.fffffep127 |
Minimum Normal Value |
0x1.0p-126 |
Maximum Subnormal Value |
0x0.fffffep-126 |
Float.MIN_VALUE |
0x0.000002p-126 |
f - float быть преобразованным.public static Float valueOf(String s) throws NumberFormatException
Float объект, содержащий float значение представляется строкой параметра s. Если s null, тогда a NullPointerException бросается.
Продвижение и запаздывание пробельных символов в s игнорируются. Пробел удаляется как будто String.trim() метод; то есть, и пробелы ASCII и управляющие символы удаляются. Остальная часть s должен составить FloatValue как описано лексическими правилами синтаксиса:
где Знак, FloatingPointLiteral, HexNumeral, HexDigits, SignedInteger и FloatTypeSuffix как определяются в лексических разделах структуры Спецификации языка Java™, за исключением того, что подчеркивания не принимаются между цифрами. Если
- FloatValue:
- Signopt
NaN- Signopt
Infinity- Signopt FloatingPointLiteral
- Signopt HexFloatingPointLiteral
- SignedInteger
- HexFloatingPointLiteral:
- HexSignificand BinaryExponent FloatTypeSuffixopt
- HexSignificand:
- HexNumeral
- HexNumeral
.0xHexDigitsopt.HexDigits0XHexDigitsopt.HexDigits
- BinaryExponent:
- BinaryExponentIndicator SignedInteger
- BinaryExponentIndicator:
pP
s не имеет формы FloatValue, тогда a NumberFormatException бросается. Иначе, s расценивается как представление точного десятичного значения в обычном "компьютеризированном экспоненциальном представлении" или как точное шестнадцатеричное значение; это точное численное значение тогда концептуально преобразовывается в "бесконечно точное" двоичное значение, которое тогда округляется, чтобы ввести float по обычному правилу раунда-к-самому-близкому IEEE 754 арифметика с плавающей точкой, которая включает сохранение знака нулевого значения. Отметьте, что правило раунда-к-самому-близкому также подразумевает поведение потери значимости и переполнение; если точное значение s является достаточно большим в величине (больше чем или равный (MAX_VALUE + ulp(MAX_VALUE)/2), округление к float приведет к бесконечности и если точное значение s является достаточно маленьким в величине (меньше чем или равный MIN_VALUE/2), округление, чтобы плавать приведет к нулю. Наконец, после округления a Float объект, представляющий это float значение возвращается. Чтобы интерпретировать локализованные строковые представления значения с плавающей точкой, используйте подклассы NumberFormat.
Отметьте, что запаздывающие спецификаторы формата, спецификаторы, которые определяют тип литерала с плавающей точкой (1.0f a float значение; 1.0d a double значение), не влияйте на результаты этого метода. Другими словами численное значение строки ввода преобразовывается непосредственно в целевой тип с плавающей точкой. Вообще, двухступенчатая последовательность преобразований, представьте в виде строки к double сопровождаемый double к float, не эквивалентно преобразованию строки непосредственно к float. Например, если сначала преобразовано в промежуточное звено double и затем к float, строка
"1.00000017881393421514957253748434595763683319091796875001d"
результаты в float значение 1.0000002f; если строка преобразовывается непосредственно в float, 1.0000001f результаты.
Избегать вызывать этот метод на недопустимой строке и иметь a NumberFormatException будьте брошены, документация для Double.valueOf перечисляет регулярное выражение, которое может использоваться, чтобы экранировать ввод.
s - строка, которая будет проанализирована.Float объект, содержащий значение, представленное String параметр.NumberFormatException - если строка не содержит parsable число.public static Float valueOf(float f)
Float экземпляр, представляющий указанное float значение. Если новое Float экземпляр не требуется, этот метод должен обычно использоваться в предпочтении к конструктору Float(float), поскольку этот метод, вероятно, приведет к значительно лучшей производительности пространства и времени, кэшируя часто требуемые значения.f - значение плавающее.Float представление экземпляра f.public static float parseFloat(String s) throws NumberFormatException
float инициализированный к значению представляется указанным String, как выполняющийся valueOf метод class Float.s - строка, которая будет проанализирована.float значение представляется строковым параметром.NullPointerException - если строка является нулемNumberFormatException - если строка не содержит parsable float.valueOf(String)public static boolean isNaN(float v)
true если конкретное количество является Не-числом (НЭН) значение, false иначе.v - значение, которое будет протестировано.true если параметром является НЭН; false иначе.public static boolean isInfinite(float v)
true если конкретное количество является бесконечно большим в величине, false иначе.v - значение, которое будет протестировано.true если параметром является положительная бесконечность или отрицательная бесконечность; false иначе.public static boolean isFinite(float f)
true если параметром является конечное значение с плавающей точкой; возвраты false иначе (для НЭН и параметров бесконечности).f - float значение, которое будет протестированоtrue если параметром является конечное значение с плавающей точкой, false иначе.public boolean isNaN()
true если это Float значение является Не-числом (НЭН), false иначе.true если значением, представленным этим объектом, является НЭН; false иначе.public boolean isInfinite()
true если это Float значение является бесконечно большим в величине, false иначе.true если значение, представленное этим объектом, является положительной бесконечностью или отрицательной бесконечностью; false иначе.public String toString()
Float объект. Примитив float значение, представленное этим объектом, преобразовывается в a String точно, как будто методом toString из одного параметра.toString в class ObjectString представление этого объекта.toString(float)public byte byteValue()
Float как a byte после сужающегося примитивного преобразования.public short shortValue()
Float как a short после сужающегося примитивного преобразования.shortValue в class Numberfloat значение, представленное этим объектом, преобразованным в тип shortpublic int intValue()
Float как int после сужающегося примитивного преобразования.public long longValue()
Float как a long после сужающегося примитивного преобразования.public float floatValue()
float значение этого Float объект.floatValue в class Numberfloat значение представляется этим объектомpublic double doubleValue()
Float как a double после расширяющегося примитивного преобразования.doubleValue в class Numberfloat значение, представленное этим объектом, преобразованным в тип doublepublic int hashCode()
Float объект. Результатом является целочисленное разрядное представление, точно как произведено методом floatToIntBits(float), из примитива float значение представляется этим Float объект.hashCode в class ObjectObject.equals(java.lang.Object), System.identityHashCode(java.lang.Object)public static int hashCode(float value)
float значение; совместимый с Float.hashCode().float значение.public boolean equals(Object obj)
true если и только если параметр не null и a Float объект, который представляет a float с тем же самым значением как float представленный этим объектом. С этой целью, два float значения, как полагают, являются тем же самым если и только если метод floatToIntBits(float) возвращает идентичное int оцените когда применено к каждого. Отметьте что в большинстве случаев для двух экземпляров class Float, f1 и f2, значение f1.equals(f2) true если и только если
f1.floatValue() == f2.floatValue()
также имеет значение true. Однако, есть два исключения:
f1 и f2 оба представляют Float.NaN, тогда equals возвраты метода true, даже при том, что Float.NaN==Float.NaN имеет значение false. f1 представляет +0.0f в то время как f2 представляет -0.0f, или наоборот, equal у теста есть значение false, даже при том, что 0.0f==-0.0f имеет значение true. equals в class Objectobj - объект, который будет сравненtrue если объекты являются тем же самым; false иначе.floatToIntBits(float)public static int floatToIntBits(float value)
Бит 31 (бит, который выбирается маской 0x80000000) представляет знак числа с плавающей точкой. Биты 30-23 (биты, которые выбираются маской 0x7f800000) представьте экспоненту. Биты 22-0 (биты, которые выбираются маской 0x007fffff) представьте мантиссу (иногда названный мантиссой) числа с плавающей точкой.
Если параметром является положительная бесконечность, результат 0x7f800000.
Если параметром является отрицательная бесконечность, результат 0xff800000.
Если параметром является НЭН, результат 0x7fc00000.
Во всех случаях результатом является целое число что, когда дано intBitsToFloat(int) метод, произведет значение с плавающей точкой то же самое как параметр floatToIntBits (кроме всей НЭН значения сворачиваются к единственному "каноническому" значению НЭН).
value - число с плавающей точкой.public static int floatToRawIntBits(float value)
Бит 31 (бит, который выбирается маской 0x80000000) представляет знак числа с плавающей точкой. Биты 30-23 (биты, которые выбираются маской 0x7f800000) представьте экспоненту. Биты 22-0 (биты, которые выбираются маской 0x007fffff) представьте мантиссу (иногда названный мантиссой) числа с плавающей точкой.
Если параметром является положительная бесконечность, результат 0x7f800000.
Если параметром является отрицательная бесконечность, результат 0xff800000.
Если параметром является НЭН, результатом является целое число, представляющее фактическое значение НЭН. В отличие от этого floatToIntBits метод, floatToRawIntBits не сворачивает все комбинации двоичных разрядов, кодирующие НЭН к единственному "каноническому" значению НЭН.
Во всех случаях результатом является целое число что, когда дано intBitsToFloat(int) метод, произведет значение с плавающей точкой то же самое как параметр floatToRawIntBits.
value - число с плавающей точкой.public static float intBitsToFloat(int bits)
float значение, соответствующее данному разрядному представлению. Параметром, как полагают, является представление значения с плавающей точкой согласно IEEE 754 "единственный формат с плавающей точкой" разрядное расположение. Если параметр 0x7f800000, результатом является положительная бесконечность.
Если параметр 0xff800000, результатом является отрицательная бесконечность.
Если параметром является какое-либо значение в диапазоне 0x7f800001 через 0x7fffffff или в диапазоне 0xff800001 через 0xffffffff, результатом является НЭН. Никакой IEEE 754 работа с плавающей точкой, обеспеченная Java, не может различить два значения НЭН того же самого типа с различными комбинациями двоичных разрядов. Отличные значения НЭН только различимы при помощи Float.floatToRawIntBits метод.
Во всех других случаях позвольте s, e, и м. быть тремя значениями, которые могут быть вычислены от параметра:
int s = ((bits >> 31) == 0) ? 1 : -1;
int e = ((bits >> 23) & 0xff);
int m = (e == 0) ?
(bits & 0x7fffff) << 1 :
(bits & 0x7fffff) | 0x800000;
Затем результат с плавающей точкой равняется значению математического выражения s · м. · 2e-150. Отметьте, что этот метод, возможно, не в состоянии возвратить a float НЭН с точно той же самой комбинацией двоичных разрядов как int параметр. IEEE 754 различает два вида NaNs, тихого NaNs и сигнального NaNs. Различия между двумя видами НЭН обычно не видимы в Java. Арифметические операции при сигнализации NaNs превращают их в тихий NaNs с различным, но часто подобная, комбинация двоичных разрядов. Однако, на некоторых процессорах, просто копируя сигнальную НЭН также выполняет то преобразование. В частности копирование сигнальной НЭН, чтобы возвратить это методу вызова может выполнить это преобразование. Так intBitsToFloat возможно, не в состоянии возвратить a float с сигнальной комбинацией двоичных разрядов НЭН. Следовательно, для некоторых int значения, floatToRawIntBits(intBitsToFloat(start)) возможно, не равняется start. Кроме того то, какие определенные комбинации двоичных разрядов представляют сигнальный NaNs, является зависимой платформой; хотя все комбинации двоичных разрядов НЭН, тихие или сигнализация, должны быть в диапазоне НЭН, идентифицированном выше.
bits - целое число.float значение с плавающей точкой с той же самой комбинацией двоичных разрядов.public int compareTo(Float anotherFloat)
Float объекты в цифровой форме. Есть два пути, которыми сравнения, выполняемые этим методом, отличаются от выполняемых языком Java числовые операторы сравнения (<, <=, ==, >=, >) когда применено к примитивный float значения: Float.NaN как полагает этот метод, равен себе и больше чем все другой float значения (включая Float.POSITIVE_INFINITY). 0.0f как полагает этот метод, больше чем -0.0f. Float объекты, наложенные этим методом, являются непротиворечивыми с, равняется.compareTo в интерфейсе Comparable<Float>anotherFloat - Float быть сравненным.0 если anotherFloat в цифровой форме равно этому Float; значение меньше чем 0 если это Float в цифровой форме меньше чем anotherFloat; и значение, больше чем 0 если это Float в цифровой форме больше чем anotherFloat.Comparable.compareTo(Object)public static int compare(float f1,
float f2)
float значения. Знак возвращенного целочисленного значения является тем же самым как тем из целого числа, которое было бы возвращено вызовом:
new Float(f1).compareTo(new Float(f2))
f1 - первое float сравниться.f2 - второе float сравниться.0 если f1 в цифровой форме равно f2; значение меньше чем 0 если f1 в цифровой форме меньше чем f2; и значение, больше чем 0 если f1 в цифровой форме больше чем f2.public static float sum(float a,
float b)
float значения вместе согласно + оператор.a - первый операндb - второй операндa и bBinaryOperatorpublic static float max(float a,
float b)
float значения, как будто, вызывая Math.max.a - первый операндb - второй операндa и bBinaryOperatorpublic static float min(float a,
float b)
float значения, как будто, вызывая Math.min.a - первый операндb - второй операндa и bBinaryOperator
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92