Float.ValueOf Método

Definição

Sobrecargas

Nome Description
ValueOf(String)

Retorna um Float objeto que contém o float valor representado pela cadeia de scaracteres de argumento.

ValueOf(Single)

Retorna uma Float instância que representa o valor especificado float .

ValueOf(String)

Retorna um Float objeto que contém o float valor representado pela cadeia de scaracteres de argumento.

[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

Parâmetros

s
String

a cadeia de caracteres a ser analisada.

Retornos

um Float objeto que contém o valor representado pelo String argumento.

Atributos

Exceções

se string não puder ser analisado como um valor flutuante.

Comentários

Retorna um Float objeto que contém o float valor representado pela cadeia de scaracteres de argumento.

Se s for null, então um NullPointerException é lançado.

Os caracteres de espaço em s branco à esquerda e à direita são ignorados. O espaço em branco é removido como se fosse pelo String#trim método; ou seja, o espaço ASCII e os caracteres de controle são removidos. O restante s deve constituir um FloatValue , conforme descrito pelas regras de sintaxe lexical:

<blockquote><dl><dt>FloatValue:<dd>Sign<sub>opt</sub>NaN<dd>Sign<sub>opt</sub>Infinity<dd>Sign<sub>opt</sub> floatingPointLiteral<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>>.dd<>>./dl<>

<dl><dt>BinaryExponent:<dd>BinaryExponentIndicator SignedInteger</dl>

<dl><dt>BinaryExponentIndicator:<dd><pdd>P</dl>

</blockquote>

onde Sign, FloatingPointLiteral, HexNumeral, HexDigits, SignedInteger e FloatTypeSuffix são definidos nas seções de estrutura lexical do <cite>The Java Language Specification</cite>, exceto que sublinhados não são aceitos entre dígitos. Se s não tiver a forma de um FloatValue, um NumberFormatException será lançado. Caso contrário, s é considerado como representando um valor decimal exato na "notação científica computada" usual ou como um valor hexadecimal exato; esse valor numérico exato é convertido conceitualmente em um valor binário "infinitamente preciso" que é arredondado para digitar float pela regra usual de volta para mais próxima da aritmética de ponto flutuante IEEE 754, que inclui preservar o sinal de um valor zero.

Observe que a regra de ida e volta para a mais próxima também implica comportamento de estouro e subfluxo; se o valor exato for s grande o suficiente em magnitude (maior ou igual a (#MAX_VALUE + Math#ulp(float) ulp(MAX_VALUE)/2), arredondar para float resultará em um infinito e se o valor exato for s pequeno o suficiente em magnitude (menor ou igual a #MIN_VALUE/2), arredondar para flutuar resultará em zero.

Por fim, depois de arredondar um Float objeto que representa esse float valor é retornado.

Para interpretar representações de cadeia de caracteres localizadas de um valor de ponto flutuante, use subclasses de java.text.NumberFormat.

Observe que especificadores de formato à direita, especificadores que determinam o tipo de um literal de ponto flutuante (1.0f é um float valor; 1.0d é um double valor),<> não< em/em influenciam> os resultados desse método. Em outras palavras, o valor numérico da cadeia de caracteres de entrada é convertido diretamente no tipo de ponto flutuante de destino. Em geral, a sequência de duas etapas de conversões, cadeia de caracteres a double ser seguida por double , floaté <em>não</em> equivalente a converter uma cadeia de caracteres diretamente em float. Por exemplo, se convertido primeiro em um intermediário double e depois para float, a cadeia de caracteres<br>"1.00000017881393421514957253748434595763683319091796875001d"<br> resulta no float valor1.0000002f; se a cadeia de caracteres for convertida diretamente em floatresultados. 1.000000<b>1</b>f

Para evitar chamar esse método em uma cadeia de caracteres inválida e ter um NumberFormatException lançamento, a documentação lista Double#valueOf Double.valueOf uma expressão regular que pode ser usada para exibir a entrada.

Documentação Java para java.lang.Float.valueOf(java.lang.String).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Confira também

Aplica-se a

ValueOf(Single)

Retorna uma Float instância que representa o valor especificado 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

Parâmetros

f
Single

um valor flutuante.

Retornos

uma Float instância que frepresenta .

Atributos

Comentários

Retorna uma Float instância que representa o valor especificado float . Se uma nova Float instância não for necessária, esse método geralmente deverá ser usado em preferência ao construtor #Float(float), pois esse método provavelmente produzirá um desempenho de espaço e tempo significativamente melhor armazenando valores solicitados com frequência.

Adicionado em 1.5.

Documentação Java para java.lang.Float.valueOf(float).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Aplica-se a