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.

Propriedades

Float32Array.BYTES_PER_ELEMENT

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.

Float32Array.name

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

Float32Array.prototype

Prototype para os objetos TypedArray.

Métodos

Float32Array.from()

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

Float32Array.of()

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.

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 Somente leitura

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

Float32Array.prototype.byteLength 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 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 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()

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

Float32Array.prototype.entries()

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()

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

Float32Array.prototype.fill()

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()

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()

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()

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()

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

Float32Array.prototype.includes() 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()

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()

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

Float32Array.prototype.keys()

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

Float32Array.prototype.lastIndexOf()

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()

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().

Float32Array.prototype.reduce()

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()

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()

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()

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

Float32Array.prototype.slice()

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

Float32Array.prototype.some()

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()

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

Float32Array.prototype.values()

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()

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

Float32Array.prototype.toString()

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

Float32Array.prototype[@@iterator]()

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