Float.ValueOf Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
ValueOf(Single) |
Retourne une |
ValueOf(String) |
Retourne un |
ValueOf(Single)
Retourne une Float
instance représentant la valeur spécifiée 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
Paramètres
- f
- Single
valeur float.
Retours
instance Float
représentant f
.
- Attributs
Remarques
Retourne une Float
instance représentant la valeur spécifiée float
. Si une nouvelle Float
instance n’est pas requise, cette méthode doit généralement être utilisée en préférence pour le constructeur #Float(float)
, car cette méthode est susceptible de produire de meilleurs performances d’espace et de temps en mettant en cache les valeurs fréquemment demandées.
Ajouté à la version 1.5.
Documentation Java pour java.lang.Float.valueOf(float)
.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.
S’applique à
ValueOf(String)
Retourne un Float
objet contenant la float
valeur représentée par la chaîne s
d’argument .
[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
Paramètres
- s
- String
chaîne à analyser.
Retours
objet Float
contenant la valeur représentée par l’argument String
.
- Attributs
Exceptions
s’il string
ne peut pas être analysé en tant que valeur float.
Remarques
Retourne un Float
objet contenant la float
valeur représentée par la chaîne s
d’argument .
Si s
c’est null
le cas, une NullPointerException
est levée.
Les espaces blancs de début et de fin sont s
ignorés. L’espace blanc est supprimé comme si par la String#trim
méthode ; autrement dit, les caractères d’espace ASCII et de contrôle sont supprimés. Le reste de s
doit constituer une valeur FloatValue , comme décrit par les règles de syntaxe lexicale :
<blockquote><dl><dt>FloatValue :<dd>Sign<sub>opt</sub><NaN
dd>Sign sub>opt</sub>Infinity
<dd><Sign<sub opt</sub>> floatPointLiteral<dd><Sign sub>opt</sub> HexFloatingPointLiteral<dd>SignedInteger</dl>
<dl><dt>HexFloatingPointLiteral : <dd>HexSignificand BinaryExponent 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>BinaryExponent :<dd>BinaryExponentIndicator SignedInteger</dl>
<dl><dt>BinaryExponentIndicator :<dd>p
<dd>P
</dl>
</blockquote>
où Sign, FloatPointLiteral, HexNumeral, HexDigits, SignedInteger et FloatTypeSuffix sont définis dans les sections de structure lexicale de <la citation>La spécification</cite> du langage Java, sauf que les traits de soulignement ne sont pas acceptés entre les chiffres. S’il s
n’a pas la forme d’une valeur FloatValue, il NumberFormatException
est levée. Sinon, s
elle est considérée comme représentant une valeur décimale exacte dans la « notation scientifique informatisée » habituelle ou comme une valeur hexadécimale exacte ; cette valeur numérique exacte est ensuite convertie conceptuellement en une valeur binaire « infiniment précise » qui est ensuite arrondie au type float
par la règle arrondie à la plus proche habituelle de l’IEEE 754 arithmétique à virgule flottante, qui inclut la conservation du signe d’une valeur zéro.
Notez que la règle la plus proche implique également un dépassement de capacité et un comportement de sous-flux ; si la valeur exacte de la valeur est s
suffisamment grande en grandeur (supérieure ou égale à (#MAX_VALUE
Math#ulp(float) ulp(MAX_VALUE)
+ /2), l’arrondi à float
provoquera une infinité et si la valeur exacte est s
suffisamment petite en magnitude (inférieure ou égale à #MIN_VALUE
/2), l’arrondi à float entraînera un zéro.
Enfin, après avoir arrondi un Float
objet représentant cette float
valeur est retourné.
Pour interpréter les représentations de chaîne localisées d’une valeur à virgule flottante, utilisez des sous-classes de java.text.NumberFormat
.
Notez que les spécificateurs de format de fin, les spécificateurs qui déterminent le type d’un littéral à virgule flottante (1.0f
est une float
valeur ; 1.0d
est une double
valeur), n’influencent>< pas</em> les résultats de cette méthode. En d’autres termes, la valeur numérique de la chaîne d’entrée est convertie directement en type à virgule flottante cible. En général, la séquence à deux étapes de conversions, chaîne à double
suivre en double
float
, est <em>not</em> équivalente à la conversion d’une chaîne directement en float
. Par exemple, si elle est d’abord convertie en intermédiairedouble
, puis en float
, la chaîne<br br<>"1.00000017881393421514957253748434595763683319091796875001d"
> génère la float
valeur 1.0000002f
; si la chaîne est convertie directement en float
résultats. 1.000000<b>1</b>f
Pour éviter d’appeler cette méthode sur une chaîne non valide et d’avoir une NumberFormatException
levée, la documentation pour Double#valueOf Double.valueOf
répertorier une expression régulière qui peut être utilisée pour analyser l’entrée.
Documentation Java pour java.lang.Float.valueOf(java.lang.String)
.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.