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 umaFloat32Array
. - Float32Array.length
-
Método estático cujo o valor é
0
. Para o tamanho atual (número de elementos), vejaFloat32Array.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émArray.from()
. Float32Array.of()
-
Cria uma nova
Float32Array
with um número variável de argumentos. Veja tambémArray.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 ArrayFloat32Array
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 seuArrayBuffer
. 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 seuArrayBuffer
. 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 seuArrayBuffer
. 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émArray.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émArray.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émArray.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
oufalse
como apropriado. Veja tambémArray.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émArray.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émArray.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
:
// 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.
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]);