API Int16Array

Int16Array

固定长度的有符号 16 位整数紧凑数组。

脚本 API 参考

new Int16Array(length) 使用初始为零的连续 short 存储。适用于音频采样、坐标增量与中范围计数器。长度固定，push/pop 不可用。

概述

Int16Array 是用于紧凑有符号 short 数据（如音频采样、坐标增量与中范围计数器）的原生支持数组。元素位于连续原生存储中，因此避免了一般 Array 的逐元素对象分配。

长度在构造时固定。push、pop 与元素删除不可用；通过数值索引读写元素。

var samples = new Int16Array(2);
samples[0] = -1024;
return samples[0]; // -1024

Warning

在 0 到 length - 1 之外索引会引发运行时错误。读写前请验证计算出的索引。

当有符号 16 位整数范围过小时使用 Int32Array；当元素类型必须变化或集合需要增长时使用 Array。

构造函数

new Int16Array([length])

参数

Name	Type	Required	说明
length	number	No	非负元素数量。省略则创建空数组。

Returns

Int16Array — 固定长度数组，元素初始为 0。

示例

var deltas = new Int16Array(4);
return deltas[3]; // 0

属性

values.length

Returns

number — 固定元素数量。

行为

只读。对给定实例该值永不改变。

示例

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

方法

values.fill([value])

参数

Name	Type	Required	说明
value	number	No	写入每个元素的值。默认为 0。

Returns

Int16Array — 本数组，可链式调用。

行为

值在存储前转换为有符号 16 位整数，每个元素会被原地覆盖。

示例

var samples = new Int16Array(3);
samples.fill(-5);
return samples[2]; // -5