Float.ValueOf Méthode

[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

Retours

instance Float représentant f.

Attributs

RegisterAttribute

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.

[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

Retours

objet Float contenant la valeur représentée par l’argument String .

Attributs

RegisterAttribute

Exceptions

Remarques

Retourne un Float objet contenant la float valeur représentée par la chaîne sd’argument .

Si s c’est nullle 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_opt<NaNdd>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_opt</dl>

<dl><dt>HexSignificand :<dd>HexNumeral<dd>HexNumeral<.dd>0xHexDigits<sub opt</sub>>. HexDigits dd>0X HexDigits<_opt.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_VALUEMath#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.0fest 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 doublefloat, 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 floatré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.

Voir aussi

• ParseFloat(String)