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

Propriedades

Int16Array.BYTES_PER_ELEMENT (en-US)

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

Int16Array.name (en-US)

Retorna o valor da string do nome do construtor. No caso do tipo Int16Array: "Int16Array".

Int16Array.prototype (en-US)

Protótipo para os objetos TypedArray.

Métodos

Int16Array.from() (en-US)

Cria um novo Int16Array de um objeto semelhante a uma matriz ou iterável. Veja também Array.from().

Int16Array.of() (en-US)

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

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 (en-US) Somente leitura

Retorna o ArrayBuffer referenciado pelo Int16Array Fixado em tempo de construção e apenas leitura.

Int16Array.prototype.byteLength (en-US) 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 (en-US) 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 (en-US) 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() (en-US)

Copia uma sequência de elementos da matriz dentro da matriz. Veja também Array.prototype.copyWithin().

Int16Array.prototype.entries() (en-US)

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

Testa se todos os elementos na matriz passam no teste fornecido por uma função. Veja também Array.prototype.every().

Int16Array.prototype.fill() (en-US)

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

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

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

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

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

Int16Array.prototype.includes() (en-US) Experimental

Determina se uma matriz tipificada inclui um determinado elemento, retornando true ou false. Veja também Array.prototype.includes().

Int16Array.prototype.indexOf() (en-US)

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

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

Int16Array.prototype.keys() (en-US)

Retorna um novo Array Iterator que contém uma chave para cada índice no array. Veja também Array.prototype.keys().

Int16Array.prototype.lastIndexOf() (en-US)

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

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

Int16Array.prototype.reduce() (en-US)

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

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

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

Armazena vários valores na matriz tipada, lendo valores de entrada de uma matriz especificada.

Int16Array.prototype.slice() (en-US)

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

Int16Array.prototype.some() (en-US)

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

Retorna um novo Int16Array a partir do índice de elemento inicial e final fornecido.

Int16Array.prototype.values() (en-US)

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

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

Int16Array.prototype.toString() (en-US)

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

Int16Array.prototype[@@iterator]() (en-US)

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