blob: 786c5556161f7e105abdb355dd53640321b1c79a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
---
title: Math.fround()
slug: Web/JavaScript/Reference/Global_Objects/Math/fround
translation_of: Web/JavaScript/Reference/Global_Objects/Math/fround
---
<div>{{JSRef("Global_Objects", "Math")}}</div>
<h2 id="Summary">概述</h2>
<p><strong><code>Math.fround()</code></strong> 可以将任意的数字转换为离它最近的<a class="external" href="https://en.wikipedia.org/wiki/Single-precision_floating-point_format" title="link to the wikipedia page on single-precision floating-point format">单精度浮点数</a>形式的数字。</p>
<h2 id="Syntax">语法</h2>
<pre class="brush: js"><code>Math.fround(<var>doubleFloat</var>)</code></pre>
<h3 id="Parameters">参数</h3>
<dl>
<dt><code>doubleFloat</code></dt>
<dd>一个 {{jsxref("Number")}}。若参数为非数字类型，则会被转投成数字。无法转换时，设置成{{jsxref("NaN")}}。</dd>
</dl>
<h3 id="Parameters">返回值</h3>
<p>指定数字最接近的<a href="https://en.wikipedia.org/wiki/Single-precision_floating-point_format">32位单精度</a>浮点数表示。</p>
<h2 id="Examples">描述</h2>
<p>JavaScript 内部使用64位的双浮点数字，支持很高的精度。但是，有时你需要用32位浮点数字，比如你从一个{{jsxref("Float32Array")}} 读取值时。这时会产生混乱：检查一个64位浮点数和一个32位浮点数是否相等会失败，即使二个数字几乎一模一样。</p>
<p>要解决这个问题，可以使用 <code>Math.fround()</code> 来将64位的浮点数转换为32位浮点数。在内部，JavaScript 继续把这个数字作为64位浮点数看待，仅仅是在尾数部分的第23位执行了“舍入到偶数”的操作，并将后续的尾数位设置为0。如果数字超出32位浮点数的范围，则返回 {{jsxref("Infinity")}} 或 <code>-Infinity</code>。</p>
<p>因为<code>fround()</code> 是<code>Math</code> 的静态方法，你必须通过 <code>Math.fround()</code> 来使用，而不是调用你创建的<code>Math</code> 对象的一个实例方法（<code>Math</code>不是一个构造函数）。</p>
<h2 id="Examples">示例</h2>
<h3 id="使用_Math.fround()">使用 Math.fround()</h3>
<p>数字1.5可以在二进制数字系统中精确表示，32位和64位的值相同：</p>
<pre class="brush: js">Math.fround(1.5); // 1.5
Math.fround(1.5) === 1.5; // true</pre>
<p>但是，数字1.337却无法在二进制数字系统中精确表示，所以32位和64位的值是不同的：</p>
<pre class="brush: js">Math.fround(1.337); // 1.3370000123977661
Math.fround(1.337) === 1.337; // false
</pre>
<p>2^150 超出32位浮点，所以返回<code>Infinity</code>：</p>
<pre class="brush: js">2 ** 150; // 1.42724769270596e+45
Math.fround(2 ** 150); // Infinity
</pre>
<p>如果参数无法转换成数字，或者为 {{jsxref("NaN")}} （<code>NaN</code>），<code>Math.fround()</code> 会返回 <code>NaN</code>：</p>
<pre class="brush: js">Math.fround('abc'); // NaN
Math.fround(NaN); // NaN
</pre>
<p>在某些精度不高的场合下，可以通过将二个浮点数转换成32位浮点数进行比较，以解决64位浮点数比较结果不正确的问题：</p>
<pre class="brush: js">0.1 + 0.2 == 0.3; //false
function equal(v1, v2) {
return Math.fround(v1) == Math.fround(v2);
}
equal(0.1 + 0.2, 0.3); //true
</pre>
<h2 id="Polyfill">Polyfill</h2>
<p>下面的函数可以模拟这个 API，前提是浏览器必须已经支持 {{jsxref("Float32Array")}}：</p>
<pre class="brush: js">Math.fround = Math.fround || (function (array) {
return function(x) {
return array[0] = x, array[0];
};
})(new Float32Array(1));</pre>
<h2 id="Specifications">规范</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">规范名称</th>
<th scope="col">规范状态</th>
</tr>
<tr>
<td>{{SpecName('ES6', '#sec-math.fround', 'Math.fround')}}</td>
<td>{{Spec2('ES6')}}</td>
</tr>
</tbody>
</table>
<h2 id="浏览器兼容性">浏览器兼容性</h2>
{{Compat}}
<h2 id="See_also">相关链接</h2>
<ul>
<li>{{jsxref("Math.round()")}}</li>
</ul>
|
