API Int8Array

Int8Array

Fixed-length packed array of signed 8-bit integers.

Script API Reference

Overview

Int8Array is a primitive-backed array for compact signed-byte data such as small-range state, tile data, or flag tables. Elements live in contiguous native storage, so the array avoids the per-element object allocation of a general Array.

The length is fixed at construction. push, pop, and element deletion are unavailable; elements are read and written through numeric indexes.

var flags = new Int8Array(2);
flags[1] = -1;
return flags[1]; // -1

Warning

Indexing outside 0 to length - 1 raises a runtime error. Validate computed indexes before reading or writing.

Use Array instead when the element type must vary or when the collection has to grow.

Constructors

new Int8Array([length])

Parameters

Name	Type	Required	Description
length	number	No	Non-negative element count. Omitting it creates an empty array.

Returns

Int8Array — a fixed-length array whose elements start at 0.

Example

var bytes = new Int8Array(3);
return bytes[0]; // 0

Properties

values.length

Returns

number — the fixed element count.

Behavior

Read-only. The value never changes for a given instance.

Example

return new Int8Array(8).length; // 8

Methods

values.fill([value])

Parameters

Name	Type	Required	Description
value	number	No	Value written to every element. Defaults to 0.

Returns

Int8Array — this array, so calls can be chained.

Behavior

The value is converted to a signed 8-bit integer before it is stored, and every element is overwritten in place.

Example

var bytes = new Int8Array(2);
bytes.fill(3);
return bytes[0]; // 3