API UInt16Array

UInt16Array

Fixed-length packed array of unsigned 16-bit integers.

Script API Reference

Overview

UInt16Array is a primitive-backed array for compact unsigned short data such as character codes, identifier tables, and mid-range counters. 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 codes = new UInt16Array(2);
codes[0] = 65;
return codes[0]; // 65

Warning

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

Use Int16Array when values must be signed, or Array when the element type must vary or the collection has to grow.

Constructors

new UInt16Array([length])

Parameters

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

Returns

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

Example

var codes = new UInt16Array(4);
return codes[3]; // 0

Properties

values.length

Returns

number — the fixed element count.

Behavior

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

Example

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

Methods

values.fill([value])

Parameters

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

Returns

UInt16Array — this array, so calls can be chained.

Behavior

The value is converted to an unsigned 16-bit integer before it is stored, and every element is overwritten in place.

Example

var codes = new UInt16Array(3);
codes.fill(32);
return codes[2]; // 32