Float.ValueOf Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| ValueOf(Single) |
Возвращает экземпляр, представляющий указанное |
| ValueOf(String) |
|
ValueOf(Single)
Возвращает экземпляр, представляющий указанное Float float значение.
[Android.Runtime.Register("valueOf", "(F)Ljava/lang/Float;", "")]
public static Java.Lang.Float ValueOf(float f);[<Android.Runtime.Register("valueOf", "(F)Ljava/lang/Float;", "")>]
static member ValueOf : single -> Java.Lang.FloatПараметры
- f
- Single
значение с плавающей запятой.
Возвращаемое значение
Float экземпляр, fпредставляющий .
- Атрибуты
Комментарии
Возвращает экземпляр, представляющий указанное Float float значение. Если новый Float экземпляр не требуется, этот метод обычно следует использовать в предпочтениях конструктора #Float(float), так как этот метод, скорее всего, обеспечивает значительно лучшую производительность пространства и времени путем кэширования часто запрашиваемых значений.
Добавлено в версии 1.5.
Документация по Java для java.lang.Float.valueOf(float).
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.
Применяется к
ValueOf(String)
Float Возвращает объект, содержащий float значение, представленное строкой sаргумента.
[Android.Runtime.Register("valueOf", "(Ljava/lang/String;)Ljava/lang/Float;", "")]
public static Java.Lang.Float ValueOf(string s);[<Android.Runtime.Register("valueOf", "(Ljava/lang/String;)Ljava/lang/Float;", "")>]
static member ValueOf : string -> Java.Lang.FloatПараметры
- s
- String
строка, которая будет проанализирована.
Возвращаемое значение
Float объект, содержащий значение, представленное аргументомString.
- Атрибуты
Исключения
Значение string с плавающей запятой невозможно проанализировать.
Комментарии
Float Возвращает объект, содержащий float значение, представленное строкой sаргумента.
Если s есть null, NullPointerException то создается исключение.
Начальные и конечные символы пробелов игнорируются s . Пробелы удаляются, как если String#trim бы методом; то есть пробелы ASCII и управляющие символы удаляются. Остальная часть должна представлять собой FloatValue, как описано в лексических правилах s синтаксиса:
<blockquote><dl><dt>FloatValue:<dd Sign<>sub opt</sub>NaN<dd>Sign<>< sub dd>Sign sub><><Infinity> opt/sub> FloatingPointLiteral dd>Sign><<sub opt</sub> HexFloatingPointLiteral<<dd>SignedInteger</dl>
<dl><dt>HexFloatingPointLiteral: <dd>HexSignificand Binary Exponent FloatTypeSuffix<sub>opt</sub<>/dl>
<dl>dt>HexSignificand:<dd HexNumeral dd HexNumeral.<<dd>>0x>HexDigits<sub opt</sub HexDigits dd>0X HexDigits><sub>.> opt</sub.>HexDigits<</dl<>
<dl>dt>Binary Exponent:<dd>Binary ExponentIndicator SignedInteger</dl<>
<dl>dt>Binary ExponentIndicator:<dd dd>><pP</dl<>
</blockquote>
where Sign, FloatingPointLiteral, HexNumeral, HexDigits, SignedInteger и FloatTypeSuffix определяются в лексических разделах <структуры cite>The Java Language Specification</cite>, за исключением того, что подчеркивания не принимаются между цифрами. Если s нет формы FloatValue, NumberFormatException создается исключение. s В противном случае считается, что это точное десятичное значение в обычной "компьютеризированной научной нотации" или как точное шестнадцатеричное значение; это точное числовое значение затем концептуально преобразуется в "бесконечно точное" двоичное значение, которое затем округляется до типа float обычным правилом с круговым к ближайшему правилу IEEE 754 с плавающей запятой, которое включает сохранение знака нулевого значения.
Обратите внимание, что правило округления к ближайшей также подразумевает переполнение и поведение подтека; Если точное значение достаточно большого s размера (больше или равно ( + Math#ulp(float) ulp(MAX_VALUE)#MAX_VALUE/2), округление float приведет к бесконечности и если точное значение s достаточно небольшого размера (меньше или равно #MIN_VALUE/2), округление до нуля приведет к нулю.
Наконец, после округления Float объекта, представляющего это float значение, возвращается.
Чтобы интерпретировать локализованные строковые представления значения с плавающей запятой, используйте подклассы java.text.NumberFormat.
Обратите внимание, что описатели формата, определяющие тип литерала с плавающей запятой (1.0fэто значение; 1.0d является float double значением), не<<>> влияют на результаты этого метода. Другими словами, числовое значение входной строки преобразуется непосредственно в целевой тип с плавающей запятой. Как правило, двухфакторная последовательность преобразований, строкаdouble, за которой следует floatdouble , не <><является> эквивалентной em для преобразования строки напрямую floatв . Например, если сначала преобразуется в промежуточныйdouble, а затем floatв , строка<br><"1.00000017881393421514957253748434595763683319091796875001d"> приводит к float значению1.0000002f; если строка преобразуется непосредственно floatв результаты. 1.000000<b>1</b>f
Чтобы избежать вызова этого метода в недопустимой строке и возникновения NumberFormatException ошибки, документация по Double#valueOf Double.valueOf списку регулярных выражений, которые можно использовать для отображения входных данных.
Документация по Java для java.lang.Float.valueOf(java.lang.String).
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.