BigDecimal for Javascript 技术文档

1. 安装指南

环境要求

• Node.js 环境已安装

安装步骤

使用 npm 命令安装 BigDecimal：

npm install bigdecimal

2. 项目的使用说明

BigDecimal 是一个纯 JavaScript 实现，提供了不可变的、任意精度的、有符号十进制数的支持。它支持任意精度的十进制数学计算。

使用场景

如果你遇到了以下问题：

node> 0.1 + 0.2
0.30000000000000004

那么你需要 BigDecimal for Javascript。BigDecimal 非常适用于金融信息的计算，或者任何超过 JavaScript Number（IEEE-754 浮点数）类型的情况。

使用方法

BigDecimal 可以在浏览器和 Apache CouchDB 中使用。你可以查看简单的 BigDecimal Couch 应用演示 来比较服务器端和客户端表达式评估。

BigDecimal 在 NPM 仓库中可用于 NodeJS。

var bigdecimal = require("bigdecimal");

var i = new bigdecimal.BigInteger("1234567890abcdefghijklmn", 24);
console.log("i is " + i);

var d = new bigdecimal.BigDecimal(i);
var x = new bigdecimal.BigDecimal("123456.123456789012345678901234567890");
console.log("d * x = " + d.multiply(x));

var two = new bigdecimal.BigDecimal('2');
console.log("Average = " + d.add(x).divide(two));

var down = bigdecimal.RoundingMode.DOWN();
console.log("d / x (25 decimal places) = " + d.divide(x, 25, down));

此外，如果你全局安装 BigDecimal，还会提供一个命令行 REPL 工具 bigdecimal.js 用于实验。

bigdecimal.js

3. 项目 API 使用文档

BigDecimal 提供了与 Java 1.5 BigInteger 和 BigDecimal 类兼容的 API。以下是部分 API 的使用方法：

• BigInteger 和 BigDecimal 的构造函数接受字符串参数。
• 提供了基本的数学运算，如加法、减法、乘法和除法。
• 支持四舍五入模式。

4. 项目安装方式

从源代码构建

1. 下载 GWT SDK，版本 2.4.0。将其解压到当前目录下，名为 gwt-2.4.0/。
2. 安装 Apache Ant，如果命令行中运行 ant 命令无效，则需要下载并配置环境变量。
3. 运行以下命令进行构建：

rake clean
rake

构建完成后，CommonJS 模块将位于 lib/bigdecimal.js。

使用预构建版本

可以在 Git 仓库的标记版本中下载已构建的 JavaScript 文件。点击页面顶部的 “Download Source” 按钮并选择 vX.Y 标签。构建的代码将在 lib/bigdecimal.js 中。

---

本文档提供了 BigDecimal for Javascript 的安装、使用和 API 文档，帮助用户更好地理解和使用该库。