Flutter高精度小数处理插件vy_fixed_decimal的使用

Flutter高精度小数处理插件vy_fixed_decimal的使用

简介

vy_fixed_decimal 是一个用于管理固定小数位数和货币数字的工具库。它提供了 FixedDecimal 类来处理具有固定小数位数的数值，并支持特定的舍入策略。此外，Money 类基于 FixedDecimal 构建，可以管理货币相关的操作。

功能模块

该插件逻辑上分为三个部分：

1. Decimal 扩展与实用工具
   包含一些对 Decimal 类的扩展，例如 DecimalPoint 类、线性回归计算类等。
2. FixedDecimal 类
   主要用于金融计算，确保在不丢失精度的情况下处理小数位数。
3. Money 类
   基于 FixedDecimal 提供货币相关的功能。

FixedDecimal 类详解

参数说明

FixedDecimal 的主要参数包括：

1. 最小值与小数位数（Scale）

   • Scale 0 表示没有小数位（如 12）。
   • Scale 1 表示一位小数（如 12.3）。
   • Scale 2 表示两位小数（如 12.37）。
   • 负小数位数表示整数部分的单位（如 -1 表示十位，-2 表示百位）。
   • 默认情况下，如果数字有有限精度，则使用其自身的精度；否则默认为 Scale 10。

2. 舍入方式（Rounding） 支持以下十种舍入方式：

   • 截断（Truncate）
   • 向下取整（Floor）
   • 向上取整（Ceil）
   • 远离零（Away From Zero）
   • 半进位（Half Up）
   • 半退位（Half Down）
   • 半向零（Half Towards Zero）
   • 半远离零（Half Away From Zero）
   • 半偶数（Half To Even）
   • 半奇数（Half To Odd）

   默认舍入方式为 Half To Even。

3. 缩放策略（Scaling Policy） 缩放策略决定了如何处理不同操作数的精度差异。支持四种策略：

   • Adjust：尝试保持最小的小数位数，同时尽量减少精度损失。
   • Same As First：结果的精度与第一个操作数相同。
   • Bigger Scale：结果采用较大的精度。
   • This Or Nothing：仅当结果能够满足第一个操作数的精度时才进行缩放。

使用示例

以下是一个完整的示例，展示如何使用 vy_fixed_decimal 插件进行高精度小数运算。

import 'package:decimal/decimal.dart';
import 'package:vy_fixed_decimal/src/fixed_decimal.dart';

void main() {
  // 创建两个 FixedDecimal 实例
  FixedDecimal fixed = FixedDecimal.fromInt(5);
  FixedDecimal second = FixedDecimal.fromInt(3);

  // 简单加法运算
  FixedDecimal result = fixed + FixedDecimal.fromInt(1);
  print(result); // 输出: 6

  // 加法运算，其中一个操作数为 int
  result = fixed + 1;
  print(result); // 输出: 6

  // 使用 add 方法进行加法运算，指定小数位数
  result = fixed.add(double.parse('2.3'), scale: 1);
  print(result); // 输出: 7.3

  // 静态方法进行加法运算
  result = FixedDecimal.addition(fixed, double.parse('2.3'), scale: 1);
  print(result); // 输出: 7.3

  // 混合运算，支持 double 和 int
  result = FixedDecimal.addition(double.parse('2.3'), 5, scale: 1);
  print(result); // 输出: 7.3

  // 高精度加法运算示例
  print((FixedDecimal.parse(
              '31878018903828899277492024491376690701584023926880.0') +
          Decimal.parse('0.9'))
      .toString());
  // 输出: 31878018903828899277492024491376690701584023926881

  print((FixedDecimal.parse(
              '31878018903828899277492024491376690701584023926880.0',
              scale: 1) +
          Decimal.parse('0.9'))
      .toString());
  // 输出: 31878018903828899277492024491376690701584023926880.9

  // 静态方法进行高精度加法运算
  print(FixedDecimal.addition(
          Decimal.parse('0.9'),
          FixedDecimal.parse(
              '31878018903828899277492024491376690701584023926880.0'))
      .toString());
  // 输出: 31878018903828899277492024491376690701584023926881

  // 减法运算
  result = second - fixed;
  print(result); // 输出: -2
}