numeric_utils 0.2.3

numeric_utils: ^0.2.3 copied to clipboard

Added #

• xxxInRangeExtension: New extensions that provide an isInRange method to check if a value is within a specified range (for int, BigInt, double and Rational).
• xxxToleranceExtension: New extensions that provide isWithinTolerance methods to check if a value is within a specified tolerance of another value (for int, BigInt, double and Rational).
• DoubleToleranceExtension: The double version of xxxToleranceExtension also provides an isCloseTo method to check if a double value is close to another value, considering floating-point inaccuracies.
• xxxMultipleOfExtension: Added double and Rational versions of isMultipleOf methods.

Upgraded #

• RationalFormattingExtension.toPercentage: Now takes an optional parameter asRatio to determine whether to treat the input as a ratio value (e.g., 33/100 or 0.33) or a value between 0 and 100 (e.g., 33 out of 100). Defaults to true for backward compatibility.

Added #

• RationalParsing.tryFromString: A version of RationalParsing.fromString that returns null if parsing fails.

Added #

• RationalParsing.fromString: A new utility method that parses strings into Rational objects, supporting the output of Rational.toString (e.g., fractions like "3/4", mixed numbers like "1 3/4") as well as formats parsable by Rational.parse (e.g., integers, decimals, scientific notation). Enables round-trip serialization for JSON and other formats.

Fixed #

• Downgraded intl to 0.19.0 due to Flutter pinning

• Initial version of numeric_utils.
• Features:
  • Added RationalRoundingExtension with various rounding methods (rounded, toNearest, etc.).
    • Added RoundingMode enum.
  • Added BigIntRoundedDivisionExtension for rounded division of BigInts.
  • Added RationalFormattingExtension with toDecimalPlaces, toCurrency and toPercentage methods.
  • Added RationalCommonRoundingExtension with toDecimalPlace, toCents, toNearestHalf, toNearestThird, and toNearestQuarter methods.
  • Added BigIntMultipleOfExtension and IntMultipleOfExtension for isMultipleOf methods.
• Constants:
  • Added RationalConstants with common rational values as well as IntConstants and BigIntConstants