# 比较函数

URL: https://caijiao.org/decimaljs/05-comparison/01-compare
Source: docs/decimaljs/05-comparison/01-compare.md
Description: 介绍 decimal.js 中用于数值比较的函数，包括 equals、greaterThan、lessThan 等，帮助精准判断数值关系。

decimal.js 提供多种比较方法，用于判断两个 Decimal 实例或数值间的大小关系，返回布尔值。

## 常用比较方法

- `.equals(value)`  
  判断是否相等，返回 `true` 或 `false`。

- `.greaterThan(value)` 或 `.gt(value)`  
  判断是否大于。

- `.greaterThanOrEqualTo(value)` 或 `.gte(value)`  
  判断是否大于等于。

- `.lessThan(value)` 或 `.lt(value)`  
  判断是否小于。

- `.lessThanOrEqualTo(value)` 或 `.lte(value)`  
  判断是否小于等于。

## 参数支持

所有比较方法均支持：

- Decimal 实例  
- 字符串数字  
- 原生数字  

会自动转换为 Decimal 进行比较。

## 使用示例

```js
import Decimal from 'decimal.js';

const a = new Decimal(1.5);
const b = new Decimal('1.5');
const c = new Decimal(2);

console.log(a.equals(b));            // true
console.log(a.greaterThan(c));       // false
console.log(a.lessThanOrEqualTo(c)); // true
console.log(c.gte('2'));             // true
````

## 注意事项

* 比较不会修改任何实例。
* 使用比较函数避免原生浮点数误差导致的判断失误。

---

通过这些比较函数，你可以准确判断数值关系，提升程序的健壮性和可靠性。