Scheme算术库 for JavaScript 技术文档

1. 安装指南

1.1 下载文件

首先，从项目的GitHub仓库中下载以下两个文件：

• biginteger.js
• schemeNumber.js

1.2 文件放置

将这两个文件复制到你的Web或JavaScript项目目录中。

1.3 加载顺序

确保在项目中先加载biginteger.js，然后再加载schemeNumber.js。

2. 项目的使用说明

2.1 基本功能

javascript-bignum库提供了对Scheme语言中“精确”算术的支持，允许在JavaScript中进行高精度的整数和有理数运算。与ECMAScript的默认运算不同，该库确保在仅使用精确参数的情况下，加、减、乘、除等基本操作返回的结果是精确且数值正确的。

2.2 示例

以下是一个简单的示例，展示了如何使用该库进行精确的整数运算：

var SN = require('./schemeNumber.js');

var a = SN.exact(100);
var b = SN.exact(200);
var result = SN.add(a, b);

console.log(result); // 输出 300

2.3 文档查看

你可以通过以下方式查看详细的API文档：

• 直接查看schemeNumber.js文件中的注释。
• 使用NaturalDocs工具生成HTML文档。

3. 项目API使用文档

3.1 基本操作

• SN.add(a, b): 返回两个精确数的和。
• SN.subtract(a, b): 返回两个精确数的差。
• SN.multiply(a, b): 返回两个精确数的积。
• SN.divide(a, b): 返回两个精确数的商。

3.2 精确数表示

• SN.exact(number): 将一个JavaScript数字转换为精确数。
• SN.exactInteger(number): 将一个JavaScript数字转换为精确整数。

3.3 比较操作

• SN.eqv(a, b): 比较两个数是否相等，使用JavaScript的===进行非数值比较。

3.4 格式化方法

• SN.toFixed(number, precision): 将精确数格式化为指定精度的字符串。
• SN.toExponential(number, precision): 将精确数格式化为指数形式的字符串。
• SN.toPrecision(number, precision): 将精确数格式化为指定精度的字符串。

4. 项目安装方式

4.1 手动安装

如前所述，直接从GitHub仓库下载biginteger.js和schemeNumber.js文件，并按照正确的顺序加载到你的项目中。

4.2 使用构建脚本

项目中提供了一个build-docs脚本，可以使用NaturalDocs工具生成HTML格式的API文档。

5. 版本历史

5.1 当前稳定版本

• 1.2.0 (2012-03-04)：基于1.1.x的稳定版本。

5.2 不稳定版本

• 1.3.0 (2012-03-07)：包含新的插件API，处于开发阶段。
• 1.1.5 (2012-03-01)：修复了解析器中的一个bug。
• 1.1.2 (2011-03-19)：不再修改标准的Number.prototype对象。

5.3 初始版本

• 1.0.1 (2011-02-10)：第一个编号版本。

更多详细信息请查看CHANGES.md文件。

---

通过以上文档，你应该能够顺利安装和使用javascript-bignum库，并了解其API的基本用法。