API Int64Array

Int64Array

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

脚本 API 参考

new Int64Array(length) 使用初始为零的连续 long 存储。适用于 tick、偏移与宽整数。脚本 number 为 double，因此安全整数范围外的元素无法精确读取；需要精确持久化时请使用 TDoc。

概述

Int64Array 是用于宽有符号整数数据（如 tick 值、字节偏移与大标识符）的原生支持数组。元素位于连续原生存储中，因此避免了一般 Array 的逐元素对象分配。

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

var offsets = new Int64Array(2);
offsets[0] = -1099511627776;
return offsets[0]; // -1099511627776

Warning

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

Note

脚本 number 为双精度。Number.MIN_SAFE_INTEGER 到 Number.MAX_SAFE_INTEGER 范围外的整数无法作为脚本 number 精确表示，因此进出数组时可能丢失精度。

构造函数

new Int64Array([length])

参数

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

Returns

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

示例

var ticks = new Int64Array(4);
return ticks[3]; // 0

属性

values.length

Returns

number — 固定元素数量。

行为

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

示例

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

方法

values.fill([value])

参数

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

Returns

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

行为

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

示例

var ticks = new Int64Array(3);
ticks.fill(1000);
return ticks[2]; // 1000