JavaScript Int64 类使用文档

1. 安装指南

在开始使用之前，您需要先安装 int64 类。由于该项目不再维护，您可能需要从npm的存档中获取旧版本的包，或者从GitHub上克隆代码并进行本地安装。以下是使用npm进行安装的命令：

npm install int64

如果遇到安装问题，请确保您的npm版本是最新的，并且具有访问npm存储库的权限。

2. 项目使用说明

int64 类提供了一种在JavaScript中处理64位整数的方法。由于JavaScript原生数字类型不能精确表示超过±2^53的整数，int64 类可以作为一个替代方案，它在内部使用8字节的数组来表示64位整数。

以下是一些基础的使用示例：

const Int64 = require('int64');

// 创建Int64实例
let x = new Int64(0x123456789);
console.log(x.toString(16)); // 输出 '123456789'

let y = new Int64('123456789abcdef0');
console.log(y.toString(16)); // 输出 '123456789abcdef0'

// 基础数学运算
console.log(x.add(1).toString()); // 输出 '4886718346'
console.log(y.add(1).toString()); // 输出 'Infinity'

// 判断数字是否在JavaScript的安全整数范围内
console.log(isFinite(x)); // 输出 'true'
console.log(isFinite(y)); // 输出 'false'

// 转换为字节字符串
console.log(x.toOctetString()); // 输出 '0000000123456789'
console.log(y.toOctetString()); // 输出 '123456789abcdef0'

请注意，int64 类不支持64位整数算术，它主要用于传输和存储64位整数值。

3. 项目API使用文档

以下是一些API的基本使用方法：

• new Int64(value): 创建一个新的 Int64 实例。

  • value 可以是一个数值，十六进制字符串，或者一个包含两个32位数字（高32位和低32位）的数组。

• int64.add(value): 将 Int64 实例的值与提供的数值相加，并返回一个新的 Int64 实例。

• int64.toString(radix): 将 Int64 实例转换为字符串。如果提供了 radix 参数，将按照指定的进制进行转换。

• int64.toOctetString(): 返回 Int64 实例的8字节字符串表示形式。

• int64.toBuffer(): 返回一个新的 Buffer 实例，其中包含 Int64 实例的字节。

• int64.copy(buffer, [offset]): 将 Int64 实例的字节复制到提供的 Buffer 实例中，可指定偏移量。

4. 项目安装方式

如前所述，您可以使用npm来安装 int64 包。如果无法通过npm直接安装，您也可以选择以下方式：

• 从npm官网下载 int64 包的压缩文件，解压后手动安装到您的项目中。
• 从GitHub克隆或下载 int64 的源代码，然后使用 npm install 命令在本地构建。

请确保按照项目的依赖进行安装，以保证所有功能正常运作。