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 um Int16Array.

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ém Array.from().

Int16Array.of()

Cria um novo Int16Array com um número variável de argumentos. Veja também Array.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 pelo Int16Array Fixado em tempo de construção e apenas leitura.

Int16Array.prototype.byteLength Somente leitura

Retorna o tamanho (em bytes) de um Int16Array desde o ínicio ArrayBuffer. Fixado em tempo de construção e apenas leitura.

Int16Array.prototype.byteOffset Somente leitura

Retorna o deslocamento (em bytes) de um Int16Array desde o ínicio ArrayBuffer. 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ém Array.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ém Array.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 ou false. Veja também Array.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ém Array.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ém Array.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:

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

js
var dv = Int16Array([1, 2, 3]);
// TypeError: calling a builtin Int16Array constructor
// without new is forbidden
js
var dv = new Int16Array([1, 2, 3]);

Ver também