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

// 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 Latest Draft (ECMA-262)
The definition of 'TypedArray constructors' in that specification.
Rascunho ECMAScript 2017 mudou o construtor Int16Array para usar a operação ToIndex e permitir construtores sem argumentos.

Compatibilidade com os navegadores

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
Basic supportChrome Full support 7Edge Full support YesFirefox Full support 4IE Full support 10Opera Full support 11.6Safari Full support 5.1WebView Android Full support 4Chrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support 4Opera Android Full support 11.6Safari iOS Full support 4.2Samsung Internet Android Full support Yesnodejs Full support 0.10
Int16Array() without new throwsChrome Full support YesEdge Full support YesFirefox Full support 44IE No support NoOpera Full support YesSafari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android Full support 44Opera Android ? Safari iOS ? Samsung Internet Android ? nodejs Full support 0.12
Iterable in constructorChrome ? Edge ? Firefox Full support 52IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android Full support 52Opera Android ? Safari iOS ? Samsung Internet Android ? nodejs Full support 4.0.0
Constructor without argumentsChrome ? Edge ? Firefox Full support 55IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android Full support 55Opera Android ? Safari iOS ? Samsung Internet Android ? nodejs ?

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown

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

Etiquetas do documento e colaboradores

Colaboradores desta página: mdnwebdocs-bot, murillodmiranda
Última atualização por: mdnwebdocs-bot,