Float32Array

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

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

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