Float.ValueOf Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
ValueOf(Single) |
Mengembalikan instans yang |
ValueOf(String) |
Mengembalikan objek yang |
ValueOf(Single)
Mengembalikan instans yang Float
mewakili nilai yang ditentukan 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
Parameter
- f
- Single
nilai float.
Mengembalikan
instans yang Float
mewakili f
.
- Atribut
Keterangan
Mengembalikan instans yang Float
mewakili nilai yang ditentukan float
. Jika instans baru Float
tidak diperlukan, metode ini umumnya harus digunakan dalam preferensi konstruktor #Float(float)
, karena metode ini cenderung menghasilkan ruang dan performa waktu yang jauh lebih baik dengan menyimpan nilai yang sering diminta.
Ditambahkan dalam 1.5.
Dokumentasi Java untuk java.lang.Float.valueOf(float)
.
Bagian halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Proyek Sumber Terbuka Android dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Atribusi Creative Commons 2.5.
Berlaku untuk
ValueOf(String)
Mengembalikan objek yang Float
menyimpan nilai yang float
diwakili oleh string s
argumen .
[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
Parameter
- s
- String
string yang akan diurai.
Mengembalikan
objek yang Float
menyimpan nilai yang diwakili oleh String
argumen .
- Atribut
Pengecualian
jika string
tidak dapat diuraikan sebagai nilai float.
Keterangan
Mengembalikan objek yang Float
menyimpan nilai yang float
diwakili oleh string s
argumen .
Jika s
adalah null
, maka dilemparkan NullPointerException
.
Karakter s
spasi kosong di awal dan akhir diabaikan. Spasi kosong dihapus seolah-olah dengan String#trim
metode ; yaitu, ruang ASCII dan karakter kontrol dihapus. Sisanya s
harus merupakan FloatValue seperti yang dijelaskan oleh aturan sintaks leksikal:
<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>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>
where Sign, FloatingPointLiteral, HexNumeral, HexDigits, SignedInteger, dan FloatTypeSuffix seperti yang didefinisikan dalam bagian <struktur leksikal dari kutipan<> Spesifikasi/kutipan> Bahasa Java, kecuali bahwa garis bawah tidak diterima di antara digit. Jika s
tidak memiliki bentuk FloatValue, maka akan NumberFormatException
dilemparkan. Jika tidak, s
dianggap sebagai mewakili nilai desimal yang tepat dalam "notasi ilmiah terkomputerisasi" biasa atau sebagai nilai heksadesimal yang tepat; nilai numerik yang tepat ini kemudian dikonversi secara konseptual menjadi nilai biner "tak terbatas tepat" yang kemudian dibulatkan untuk diketik float
oleh aturan aritmetika titik mengambang IEEE 754 yang biasa, yang mencakup mempertahankan tanda nilai nol.
Perhatikan bahwa aturan round-to-nearest juga menyiratkan perilaku luapan dan underflow; jika nilai s
yang tepat cukup besar dalam besaran (lebih besar dari atau sama dengan (#MAX_VALUE
Math#ulp(float) ulp(MAX_VALUE)
+ /2), pembulatan ke float
akan menghasilkan tak terbatas dan jika nilai s
yang tepat cukup kecil dalam besaran (kurang dari atau sama dengan #MIN_VALUE
/2), pembulatan ke float akan menghasilkan nol.
Terakhir, setelah membulatkan objek yang Float
mewakili nilai ini float
dikembalikan.
Untuk menginterpretasikan representasi string yang dilokalkan dari nilai floating-point, gunakan subkelas .java.text.NumberFormat
Perhatikan bahwa penentu format berikutnya, penentu yang menentukan jenis literal floating-point (1.0f
adalah float
nilai; 1.0d
adalah double
nilai), apakah <mereka>tidak</em> memengaruhi hasil metode ini. Dengan kata lain, nilai numerik dari string input dikonversi langsung ke jenis floating-point target. Secara umum, urutan dua langkah konversi, string untuk double
diikuti dengan double
float
, adalah <mereka>tidak</em> setara dengan mengonversi string langsung ke float
. Misalnya, jika pertama kali dikonversi ke perantara double
dan kemudian ke float
, string<br br<>>"1.00000017881393421514957253748434595763683319091796875001d"
menghasilkan nilai 1.0000002f
; jika string dikonversi float
langsung ke float
, 1.000000<b>1</b>f
hasil.
Untuk menghindari pemanggilan metode ini pada string yang tidak valid dan memiliki NumberFormatException
dilemparkan, dokumentasi untuk Double#valueOf Double.valueOf
mencantumkan ekspresi reguler yang dapat digunakan untuk menyaring input.
Dokumentasi Java untuk java.lang.Float.valueOf(java.lang.String)
.
Bagian halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Proyek Sumber Terbuka Android dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Atribusi Creative Commons 2.5.