Int16Array

 

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

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

Especificação Status Comentário
Typed Array Specification Obsoleto Substituído pelo ECMAScript 2015.
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'TypedArray constructors' in that specification.
Padrão Definição inicial em um padrão ECMA. Especificado new como requerido.
ECMAScript (ECMA-262)
The definition of 'TypedArray constructors' in that specification.
Padrão em tempo real ECMAScript 2017 mudou o construtor Int16Array para usar a operação ToIndex e permitir construtores sem argumentos.

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]);

Ver também