Float32Array
============

**`Float32Array`** 类型数组代表的是平台字节顺序为 32 位的浮点数型数组 (对应于 C 浮点数据类型) 。如果需要控制字节顺序，使用 `DataView` 替代。其内容初始化为 `0`。一旦建立起来，你可以使用这个对象的方法对其元素进行操作，或者使用标准数组索引语法 (使用方括号)。

语法
--
```

new Float32Array(length);
new Float32Array(typedArray);
new Float32Array(object);
new Float32Array(buffer [, byteOffset [, length]]);
```


更多的语法信息和参数，参见 *TypedArray。*

属性
--

`Float32Array.BYTES_PER_ELEMENT`

返回元素字节数。在 `Float32Array` 的情况下返回 4。

Float32Array.length

长度属性的值为 3。关于其实际长度 (元素数量) 参见`Float32Array.prototype.length`。

`Float32Array.prototype` (en-US)

*TypedArray* 对象的原型。

方法
--

`Float32Array.from()`

从一个类数组对象或可遍历对象创建一个新的 Float32Array。参见 `Array.from()`。

`Float32Array.of()`

用可变数量的参数创建一个新的 Float32Array。参见 `Array.of()`。

`Float32Array` 属性
-----------------

所有的`Float32Array 对象都`继承自 `%TypedArray%.prototype` (en-US)。

### 特性

`Float32Array.prototype.constructor`

返回创建这个实例原型的函数。这是 `Float32Array` 默认的构造函数。

`Float32Array.prototype.buffer` 只读 

返回这个`Float32Array` 引用的 `ArrayBuffer`。构造时已固定，所以是**只读**的。

`Float32Array.prototype.byteLength` 只读 

返回从`Float32Array` 的 `ArrayBuffer` 开头开始的长度 (以字节为单位) 。构造时已固定，所以是**只读**的。

`Float32Array.prototype.byteOffset` 只读 

返回从`Float32Array` 的 `ArrayBuffer` 开头开始的偏移量（以字节为单位）。构造时已固定，所以是**只读**的。

`Float32Array.prototype.length` 只读 

返回 `Float32Array` 中的元素个数。构造时已固定，所以是**只读**的。

### 方法

`Float32Array.prototype.copyWithin()`

从数组复制元素。参见`Array.prototype.copyWithin()`。

`Float32Array.prototype.entries()`

`返回一个包含数组中每个元素键值对的数组遍历器对象`。参见`Array.prototype.entries()`。

`Float32Array.prototype.every()`

检测是否所有元素都能通过给定函数的测试。参见`Array.prototype.every()`。

`Float32Array.prototype.fill()`

用一个静态值填充给定的起始位置。参见`Array.prototype.fill()`。

`Float32Array.prototype.filter()`

创建一个新数组，数据为原数组中所有能让给入函数返回 true 的元素。参见`Array.prototype.filter()`。

`Float32Array.prototype.find()`

返回满足测试函数的值，如果没有找到，返回 undefined。参见`Array.prototype.find()`。

`Float32Array.prototype.findIndex()`

返回满足测试函数的值的位置，如果没有找到，返回 -1。参见`Array.prototype.findIndex()`。

`Float32Array.prototype.forEach()`

以每个元素为参数各调用一次函数。参见`Array.prototype.forEach()`。

`Float32Array.prototype.includes()` 
实验性

判断是否包含某个元素，返回 `true` 或 `false`。参见`Array.prototype.includes()`。

`Float32Array.prototype.indexOf()`

返回数组中等于给定值的元素的第一个（最小）位置，没有找到则返回 -1。参见`Array.prototype.indexOf()`。

`Float32Array.prototype.join()`

合并所有数组元素到一个字符串中。参见`Array.prototype.join()`。

`Float32Array.prototype.keys()`

返回一个包含数组中所有索引的数组遍历器。参见`Array.prototype.keys()`。

`Float32Array.prototype.lastIndexOf()`

返回数组中等于给定值的元素的最后（最大）位置，没有找到则返回 -1。参见`Array.prototype.lastIndexOf()`。

`Float32Array.prototype.map()`

创建一个新的数组，数据由原数组每个元素依次传入给定函数后返回的值组成。参见`Array.prototype.map()`。

`Float32Array.prototype.move()` 
非标准
 未实现

`Float32Array.prototype.copyWithin()`以前的一个非标准版本。

`Float32Array.prototype.reduce()`

传入一个函数作为累加器，从左到右遍历，最终得到一个值。参见`Array.prototype.reduce()`。

`Float32Array.prototype.reduceRight()`

传入一个函数作为累加器，从右到左遍历，最终得到一个值。参见`Array.prototype.reduceRight()`。

`Float32Array.prototype.reverse()`

反转数组元素的顺序 — 第一个变为最后一个，最后一个变为第一个。参见`Array.prototype.reverse()`。

`Float32Array.prototype.set()`

从给定的数组存入多个数值。

`Float32Array.prototype.slice()`

提取数组的一部分并且返回一个新数组。参见`Array.prototype.slice()`。

`Float32Array.prototype.some()`

如果数组中至少有一个元素满足测试函数的要求则返回 true。参见`Array.prototype.some()`。

`Float32Array.prototype.sort()`

对数组元素进行排序并返回数组。参见`Array.prototype.sort()`。

`Float32Array.prototype.subarray()`

从给定的起始位置返回一个新的`Float32Array` 。

`Float32Array.prototype.values()`

返回一个包含所有数组元素的数组遍历器对象。参见`Array.prototype.values()`。

`Float32Array.prototype.toLocaleString()`

返回一个代表数组和其元素的本地化格式字符串。参见`Array.prototype.toLocaleString()`。

`Float32Array.prototype.toString()`

返回一个代表数组和它的元素的字符串。参见`Array.prototype.toString()`。

`Float32Array.prototype[@@iterator]()`

返回一个新的包含数组元素的数组迭代器对象。

示例
--


```js
// From a length
var float32 = new Float32Array(2);
float32[0] = 42;
console.log(float32[0]); // 42
console.log(float32.length); // 2
console.log(float32.BYTES\_PER\_ELEMENT); // 4

// From an array
var arr = new Float32Array([21, 31]);
console.log(arr[1]); // 31

// From another TypedArray
var x = new Float32Array([21, 31]);
var y = new Float32Array(x);
console.log(y[0]); // 21

// From an ArrayBuffer
var buffer = new ArrayBuffer(16);
var z = new Float32Array(buffer, 0, 4);
```

规范
--

| Specification |
| --- |
| ECMAScript Language Specification # table-49 |

浏览器兼容性
------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

一致性提示
-----

从 ECMAScript 2015 (ES6) 开始， `Float32Array`构造函数需要用一个`new`操作符来构造。现在直接把`Float32Array 构造函数当函数调用而不使用 new，会抛出一个``TypeError`。


```js
var dv = Float32Array([1, 2, 3]);
// TypeError: calling a builtin Float32Array constructor
// 不允许不使用 new
```



```js
var dv = new Float32Array([1, 2, 3]);
```

参见
--

* JavaScript typed arrays
* `ArrayBuffer`
* `DataView`