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

A array tipada **`Float32Array`** representa uma array de 32-bits contendo floats (correspondendo ao tipo de dados `float` em C) na ordem dos bytes da plataforma. Se o controle sobre a ordem dos bytes for precisa, use `DataView`. Os conteúdos iniciam em `0`. Uma vez estabelecido, você pode referenciar os elementos na array usando os métodos do objeto ou usando a síntaxe padrão das arrays (Isto é, usando colchetes)

Síntaxe
-------
```

new Float32Array(); // novo no ES2017
new Float32Array(length);
new Float32Array(typedArray);
new Float32Array(object);
new Float32Array(buffer [, byteOffset [, length]]);
```


Para mais informações sobre a síntaxe de construção e os parâmetros, veja *TypedArray (en-US)*.

Propriedades
------------

`Float32Array.BYTES_PER_ELEMENT` (en-US)

Retorna um número valor do tamanho do elemento. `4` no caso de uma `Float32Array`.

Float32Array.length

Método estático cujo o valor é `0`. Para o tamanho atual (número de elementos), veja `Float32Array.prototype.length` (en-US).

`Float32Array.name` (en-US)

Retorna o valor em string do nome do constructor. No caso de `Float32Array` é "Float32Array".

`Float32Array.prototype` (en-US)

Prototype para os objetos *TypedArray*.

Métodos
-------

`Float32Array.from()` (en-US)

Cria uma nova `Float32Array` de um array-like ou um objeto iterável. Veja também `Array.from()`.

`Float32Array.of()` (en-US)

Cria uma nova `Float32Array` with um número variável de argumentos. Veja também `Array.of()`.

`Float32Array` prototype
------------------------

Todos os objetos `Float32Array` herdam de `%TypedArray%.prototype` (en-US).

### Propriedades

`Float32Array.prototype.constructor`

Retorna a função cujo criou o protótipo da instância. Este é o construtor padrão da Array `Float32Array`.

`Float32Array.prototype.buffer` (en-US) Somente leitura 

Retorna os `ArrayBuffer` referenciado pela Array `Float32Array` fixada na hora de sua construção e é **somente leitura**.

`Float32Array.prototype.byteLength` (en-US) Somente leitura 

Retorna o tamanho (em bytes) da Array `Float32Array` do começo de seu `ArrayBuffer`. Fixado na hora de sua construção e é **somente leitura**.

`Float32Array.prototype.byteOffset` (en-US) Somente leitura 

Retorna o deslocamento (em bytes) da Array `Float32Array` do começo de seu `ArrayBuffer`. Fixado na hora de sua construção e é **somente leitura**.

`Float32Array.prototype.length` (en-US) Somente leitura 

Retorna o número de elementos na Array `Float32Array` do começo de seu `ArrayBuffer`. Fixado na hora de sua construção e é **somente leitura**.

### Métodos

`Float32Array.prototype.copyWithin()` (en-US)

Copia a sequência dos elementos dentro da Array. Veja também `Array.prototype.copyWithin()`.

`Float32Array.prototype.entries()` (en-US)

Retorna um novo objeto `Array Iterator` que contém os pares chave/valor para cada índex na array. Veja também `Array.prototype.entries()`.

`Float32Array.prototype.every()` (en-US)

Testa quando todos os elementos na array passam no teste proveniente de uma função. Veja também `Array.prototype.every()`.

`Float32Array.prototype.fill()` (en-US)

Preenche todos os elementos de uma array do índex inicial ao índex final com um valor estático. Veja também `Array.prototype.fill()`.

`Float32Array.prototype.filter()` (en-US)

Cria uma nova array com todos os elementos dessa array para a função de filtragem que retornar `true`. Veja também `Array.prototype.filter()`.

`Float32Array.prototype.find()` (en-US)

Retorna o valor na array encontrado, se um elemento na array satizfaz o teste proveniente de uma função de teste ou `undefined` se não for encontrado. Veja também `Array.prototype.find()`.

`Float32Array.prototype.findIndex()` (en-US)

Retorna o index encontrado na array, se um elemento na array satizfaz o teste proveniente de uma função de teste ou -1 se não for encontrado. Veja também `Array.prototype.findIndex()`.

`Float32Array.prototype.forEach()` (en-US)

Chama uma função para cada elemento na array. Veja também `Array.prototype.forEach()`.

`Float32Array.prototype.includes()` (en-US) 
Experimental

Determina quando a array tipada inclui um certo elemento, retornando `true` ou `false` como apropriado. Veja também `Array.prototype.includes()`.

`Float32Array.prototype.indexOf()` (en-US)

Retorna o primeiro (menor) index de um elemento dentro de uma array igual ao valor expecificado, ou -1 se nenhum for encontrado. Veja também `Array.prototype.indexOf()`.

`Float32Array.prototype.join()` (en-US)

Junta todos os elementos de uma array em uma string. Veja também `Array.prototype.join()`.

`Float32Array.prototype.keys()` (en-US)

Retorna um novo `Array Iterator` cujo contem as chaves para cada index na array. Veja também `Array.prototype.keys()`.

`Float32Array.prototype.lastIndexOf()` (en-US)

Retorna o último (maior) índex de um elemento dentro da array igual ao valor especificado, ou -1 se nenhum for encontrado. Veja também `Array.prototype.lastIndexOf()`.

`Float32Array.prototype.map()` (en-US)

Cria uma nova array com os resultados da função chamada em cada elemento nesta array. Veja também `Array.prototype.map()`.

`Float32Array.prototype.move()` 
Non-standard
 Unimplemented

Versão antiga não padrão de `Float32Array.prototype.copyWithin()` (en-US).

`Float32Array.prototype.reduce()` (en-US)

Aplica uma função contra um acumulador e cada valor na array (da esquerda para a direita) com o intuito de reduzí-la a um único valor. Veja também `Array.prototype.reduce()`.

`Float32Array.prototype.reduceRight()` (en-US)

Aplica uma função contra um acumulador e cada valor na array (da direita para a esquerda) como o intuito de reduzí-la a um único valor. See also `Array.prototype.reduceRight()`.

`Float32Array.prototype.reverse()` (en-US)

Reverte a ordem se todos os elementos em uma array - o primeiro se torna o último, e o último de torna o primeiro. Veja também `Array.prototype.reverse()`.

`Float32Array.prototype.set()` (en-US)

Armazena múltiplos valores na array tipada, lendo os valores de entrada de uma array especificada.

`Float32Array.prototype.slice()` (en-US)

Extrai uma seção de uma array e retorna uma nova array. Veja também `Array.prototype.slice()`.

`Float32Array.prototype.some()` (en-US)

Retorna true se pelo menos um elemento nesta array satisfazer a função de teste proveniente de uma função de teste. Veja também `Array.prototype.some()`.

`Float32Array.prototype.sort()`

Classifica os elementos de uma array no lugar e retorna a array. Veja também `Array.prototype.sort()`.

`Float32Array.prototype.subarray()` (en-US)

Retorna uma nova Array `Float32Array` a partir de um ponto inicial e um fim pelo índex do elemento.

`Float32Array.prototype.values()` (en-US)

Retorna um novo objeto `Array Iterator` que contém os valores para cada índex na Array. Veja também `Array.prototype.values()`.

`Float32Array.prototype.toLocaleString()` (en-US)

Retorna uma string localizada representando a array e seus elementos. Veja também `Array.prototype.toLocaleString()`.

`Float32Array.prototype.toString()` (en-US)

Retorna uma string representando a array e seus elementos. Veja também `Array.prototype.toString()`.

`Float32Array.prototype[@@iterator]()` (en-US)

Retorna um novo objeto `Array Iterator` que contém os valores para cada índex na Array.

Exemplos
--------

Diferentes modos de criar uma Array `Float32Array`:


```js
// Pelo seu tamanho
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

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

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

// Por um ArrayBuffer
var buffer = new ArrayBuffer(16);
var z = new Float32Array(buffer, 0, 4);

// Por um iterável
var iterable = (function\* () {
  yield\* [1, 2, 3];
})();
var float32 = new Float32Array(iterable);
// Float32Array[1, 2, 3]
```

Especificações
--------------

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

Compatibilidade com navegadores
-------------------------------

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

Notas de compatibilidade
------------------------

Começando com o ECMAScript 2015, construtores da Array `Float32Array` requerem o uso do operador `new`. Chamando o construtor da Array `Float32Array` como uma função, sem o `new`, irá gerar um erro `TypeError` de agora em diante.


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

// TypeError: chamando o construtor da função interna Float32Array
// sem o new é proibido
```



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

Veja também
-----------

* JavaScript arrays tipadas
* `ArrayBuffer`
* `DataView`