Int16Array
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 matriz do tipo Int16Array
representa uma matriz de inteiros assinados de 16 bits com dois complementos na ordem de bytes da plataforma. Se o controle sobre a ordem de bytes for necessário, use DataView
. O conteúdo é inicializado em 0. Uma vez estabelecido, você pode fazer referência a elementos na matriz usando os métodos do objeto ou usando a sintaxe de índice da matriz padrão (ou seja, usando a notação de colchetes).
Sintaxe
new Int16Array(); // novo no ES2017 new Int16Array(length); new Int16Array(typedArray); new Int16Array(object); new Int16Array(buffer [, byteOffset [, length]]);
Para obter mais informações sobre a sintaxe do construtor e os parâmetros, consulte TypedArray.
Propriedades
Int16Array.BYTES_PER_ELEMENT
-
Retorna um valor numérico do tamanho do elemento.
2
no caso de umInt16Array
. - Int16Array.length
-
Propriedade de comprimento estático cujo valor é 0. Para o comprimento real (número de elementos), consulte
Int16Array.prototype.length
. Int16Array.name
-
Retorna o valor da string do nome do construtor. No caso do tipo
Int16Array
: "Int16Array". Int16Array.prototype
-
Protótipo para os objetos TypedArray.
Métodos
Int16Array.from()
-
Cria um novo
Int16Array
de um objeto semelhante a uma matriz ou iterável. Veja tambémArray.from()
. Int16Array.of()
-
Cria um novo
Int16Array
com um número variável de argumentos. Veja tambémArray.of()
.
Int16Array
prototype
Todos Int16Array
objetos herdam de %TypedArray%.prototype
.
Propriedades
Int16Array.prototype.constructor
-
Retorna a função que criou o protótipo de uma instância. Este é o construtor
Int16Array
por padrão. Int16Array.prototype.buffer
Somente leitura-
Retorna o
ArrayBuffer
referenciado peloInt16Array
Fixado em tempo de construção e apenas leitura. Int16Array.prototype.byteLength
Somente leitura-
Retorna o tamanho (em bytes) de um
Int16Array
desde o ínicioArrayBuffer
. Fixado em tempo de construção e apenas leitura. Int16Array.prototype.byteOffset
Somente leitura-
Retorna o deslocamento (em bytes) de um
Int16Array
desde o ínicioArrayBuffer
. Fixado em tempo de construção e apenas leitura. Int16Array.prototype.length
Somente leitura-
Retorna o número de elementos em um
Int16Array
. Fixado em tempo de construção e apenas leitura.
Métodos
Int16Array.prototype.copyWithin()
-
Copia uma sequência de elementos da matriz dentro da matriz. Veja também
Array.prototype.copyWithin()
. Int16Array.prototype.entries()
-
Retorna um novo
Array Iterator
objeto que contém os pares de chave / valor para cada índice na matriz. Veja tambémArray.prototype.entries()
. Int16Array.prototype.every()
-
Testa se todos os elementos na matriz passam no teste fornecido por uma função. Veja também
Array.prototype.every()
. Int16Array.prototype.fill()
-
Preenche todos os elementos de uma matriz de um índice inicial para um índice final com um valor estático. Veja também
Array.prototype.fill()
. Int16Array.prototype.filter()
-
Cria uma nova matriz com todos os elementos dessa matriz para os quais a função de filtragem fornecida retorna true. Veja também
Array.prototype.filter()
. Int16Array.prototype.find()
-
Retorna o valor encontrado na matriz, se um elemento na matriz satisfizer a função de teste fornecida ou
undefined
se não encontrado. Veja tambémArray.prototype.find()
. Int16Array.prototype.findIndex()
-
Retorna o índice encontrado na matriz, se um elemento na matriz satisfizer a função de teste fornecida ou -1, se não for encontrado. Veja também
Array.prototype.findIndex()
. Int16Array.prototype.forEach()
-
Chama uma função para cada elemento na matriz. Veja também
Array.prototype.forEach()
. Int16Array.prototype.includes()
Experimental-
Determina se uma matriz tipificada inclui um determinado elemento, retornando
true
oufalse
. Veja tambémArray.prototype.includes()
. Int16Array.prototype.indexOf()
-
Retorna o primeiro (menos) índice de um elemento dentro da matriz igual ao valor especificado ou -1 se nenhum for encontrado. Veja também
Array.prototype.indexOf()
. Int16Array.prototype.join()
-
Junta todos os elementos de um array em uma string. Veja também
Array.prototype.join()
. Int16Array.prototype.keys()
-
Retorna um novo
Array Iterator
que contém uma chave para cada índice no array. Veja tambémArray.prototype.keys()
. Int16Array.prototype.lastIndexOf()
-
Retorna o último (maior) índice de um elemento dentro da matriz igual ao valor especificado ou -1 se nenhum for encontrado. Veja também
Array.prototype.lastIndexOf()
. Int16Array.prototype.map()
-
Cria uma nova matriz com os resultados da chamada de uma função fornecida em todos os elementos dessa matriz. Veja também
Array.prototype.map()
. Int16Array.prototype.move()
Non-standard-
Versão não-padrão anterior de
Int16Array.prototype.copyWithin()
. Int16Array.prototype.reduce()
-
Aplique uma função contra um acumulador e cada valor da matriz (da esquerda para a direita) para reduzi-lo a um único valor. Veja também
Array.prototype.reduce()
. Int16Array.prototype.reduceRight()
-
Aplique uma função contra um acumulador e cada valor da matriz (da direita para a esquerda) para reduzi-lo a um único valor. Veja também
Array.prototype.reduceRight()
. Int16Array.prototype.reverse()
-
Inverte a ordem dos elementos de um array - o primeiro torna-se o último e o último torna-se o primeiro. Veja também
Array.prototype.reverse()
. Int16Array.prototype.set()
-
Armazena vários valores na matriz tipada, lendo valores de entrada de uma matriz especificada.
Int16Array.prototype.slice()
-
Extrai uma seção de uma matriz e retorna uma nova matriz. Veja também
Array.prototype.slice()
. Int16Array.prototype.some()
-
Retorna true se pelo menos um elemento nessa matriz satisfizer a função de teste fornecida. Veja também
Array.prototype.some()
. Int16Array.prototype.sort()
-
Classifica os elementos de uma matriz e retorna a matriz. Veja também
Array.prototype.sort()
. Int16Array.prototype.subarray()
-
Retorna um novo
Int16Array
a partir do índice de elemento inicial e final fornecido. Int16Array.prototype.values()
-
Retorna um novo objeto
Array Iterator
que contém os valores para cada índice na matriz. Veja tambémArray.prototype.values()
. Int16Array.prototype.toLocaleString()
-
Retorna uma string localizada representando a matriz e seus elementos. Veja também
Array.prototype.toLocaleString()
. Int16Array.prototype.toString()
-
Retorna uma string representando a matriz e seus elementos. Veja também
Array.prototype.toString()
. Int16Array.prototype[@@iterator]()
-
Retorna um novo objeto
Array Iterator
que contém os valores para cada índice na lista.
Exemplos
Diferentes opções de criar um Int16Array
:
// De um tamanho
var int16 = new Int16Array(2);
int16[0] = 42;
console.log(int16[0]); // 42
console.log(int16.length); // 2
console.log(int16.BYTES_PER_ELEMENT); // 2
// De uma array
var arr = new Int16Array([21, 31]);
console.log(arr[1]); // 31
// De um outro TypedArray
var x = new Int16Array([21, 31]);
var y = new Int16Array(x);
console.log(y[0]); // 21
// De um ArrayBuffer
var buffer = new ArrayBuffer(8);
var z = new Int16Array(buffer, 0, 4);
// De um interável
var iterable = (function* () {
yield* [1, 2, 3];
})();
var int16 = new Int16Array(iterable);
// Int16Array[1, 2, 3]
Especificações
Specification |
---|
ECMAScript Language Specification # table-49 |
Compatibilidade com navegadores
BCD tables only load in the browser
Notas de compatibilidade
A partir do ECMAScript 2015, os construtores Int16Array
precisam ser construídos com um operador new
. Chamar um construtor Int16Array
como uma função sem o new
, irá resultar em TypeError
.
var dv = Int16Array([1, 2, 3]);
// TypeError: calling a builtin Int16Array constructor
// without new is forbidden
var dv = new Int16Array([1, 2, 3]);