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.

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

// 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

Especificação Status Comment
Typed Array Specification Obsoleto Suplantada pelo ECMAScript 2015.
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'TypedArray constructors' in that specification.
Padrão Definição inicial no padrão ECMA. Especificado que o new é requerido.
ECMAScript (ECMA-262)
The definition of 'TypedArray constructors' in that specification.
Padrão em tempo real O ECMAScript 7 mudou o construtor da Array Array32Float para o uso da operação ToIndex e ajudar nos construtores sem argumentos.

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.

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

// TypeError: chamando o construtor da função interna Float32Array
// sem o new é proibido
var dv = new Float32Array([1, 2, 3]);

Veja também