API Int8Array

Int8Array

固定长度 8 位有符号整数数组

Fixed-length signed 8-bit integer array

脚本 API 目录

Script API Directory

概述

Overview

Int8Array 用于紧凑的有符号字节数据，例如小范围状态、图块数据或标记表。它是固定长度数组，不能 push、pop 或删除元素，越界索引会抛出运行时错误。

Int8Array is for compact signed-byte data such as small-range state, tile data, or flag tables. It has a fixed length, does not support push, pop, or deletion, and throws for out-of-range indexes.

new Int8Array([length])

Parameters:

• length
  可选的非负长度。

  Optional non-negative length.

Returns

元素初始化为 0 的 Int8Array。

An Int8Array initialized to 0.

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

length

用途

读取不可变数组长度。

Reads the immutable array length.

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

fill([value])

Parameters:

• value
  可选数值，转换为有符号 8 位整数；缺省为 0。

  Optional number converted to signed 8-bit integer; defaults to 0.

Returns

当前数组。

This array.

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