Class Int8Array

• TopLevel.Object
  • TopLevel.Int8Array

An optimized array to store 8-bit signed integer numbers. Elements of this array are stored in an ArrayBuffer object.

API Version:

Available from version 21.2.

Note

Constant Summary 

Constant	Description
BYTES_PER_ELEMENT: Number = 1	Number value of the element size.

Property Summary 

Property	Description
buffer: ArrayBuffer	The array buffer referenced by this typed array.
byteLength: Number	The number of bytes in the array buffer used by this typed array.
byteOffset: Number	The start offset for this typed array within the array buffer.
length: Number	The number of elements.

Constructor Summary 

Constructor	Description
Int8Array()	Creates an empty array.
Int8Array(Number)	Creates an array with the given element count.
Int8Array(Object)	Creates an array as a copy of the passed typed array.
Int8Array(Array)	Creates an array as a copy of the passed array.
Int8Array(ArrayBuffer, Number, Number)	Creates a typed array as a view on the given ArrayBuffer.

Method Summary 

Method	Description
get(Number)	Returns the value at the specified index.
set(Object, Number)	Copies all values from the source array into this typed array.
subarray(Number, Number)	Returns a new array object based on the same ArrayBuffer store.

Methods inherited from class Object 

assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values

Constant Details 

BYTES_PER_ELEMENT 

BYTES_PER_ELEMENT: Number = 1

Number value of the element size.

---

Property Details 

buffer 

buffer: ArrayBuffer

The array buffer referenced by this typed array.

---

byteLength 

byteLength: Number

The number of bytes in the array buffer used by this typed array.

---

byteOffset 

byteOffset: Number

The start offset for this typed array within the array buffer.

---

length 

length: Number

The number of elements.

---

Constructor Details 

Int8Array() 

Int8Array()

Creates an empty array.

---

Int8Array(Number) 

Int8Array(length: Number)

Creates an array with the given element count.

Parameters:

• length - The number of elements.

---

Int8Array(Object) 

Int8Array(typedArray: Object)

Creates an array as a copy of the passed typed array.

Parameters:

• typedArray - The source typed array.

---

Int8Array(Array) 

Int8Array(array: Array)

Creates an array as a copy of the passed array.

Parameters:

• array - The source array.

---

Int8Array(ArrayBuffer, Number, Number) 

Int8Array(buffer: ArrayBuffer, byteOffset: Number, length: Number)

Creates a typed array as a view on the given ArrayBuffer.

Parameters:

• buffer - The array buffer storage object.
• byteOffset - Optional. The offset within the array buffer in bytes.
• length - Optional. The number of elements for the target typed array. The passed array buffer must be large enough to store the number of elements specified.

---

Method Details 

get(Number) 

get(index: Number): Number

Returns the value at the specified index.

Note: This is not ECMAScript standard. Use array element access syntax for single value access.

Parameters:

• index - The index to use.

Returns:

• The value at the specified index.

---

set(Object, Number) 

set(values: Object, offset: Number): void

Copies all values from the source array into this typed array.

Parameters:

• values - The source values. Can be an array or a typed array.
• offset - Optional. Target offset.

---

subarray(Number, Number) 

subarray(begin: Number, end: Number): Int8Array

Returns a new array object based on the same ArrayBuffer store.

Parameters:

• begin - Optional. The first included element.
• end - Optional. The index of the end. This element is not included.

Returns:

• The new array object.

---