/swift_huge-numbers

Very large numbers with infinite precision.

Primary LanguageSwiftCreative Commons Zero v1.0 UniversalCC0-1.0

swift_huge-numbers

This library was created to remove the decimal precision limitation on floats, which is especially useful in scientific applications.

Installation

Requirements

  • Swift >= 5.1
  • macOS >= 10.15
  • iOS >= 13.0
  • tvOS >= 13.0
  • watchOS >= 6.0

CocoaPods

pod 'HugeNumbers', '~> 1.0.15'

or for latest version (may not be uploaded to CocoaPods yet)

pod 'HugeNumbers', :git => 'https://github.com/RandomHashTags/swift_huge-numbers.git'

Swift Package Manager

.package(url: "https://github.com/RandomHashTags/swift_huge-numbers.git", from: "1.1.0")

Current features

  • HugeInt
  • HugeFloat
  • HugeRemainder
  • HugeDecimal
  • addition, subtraction, multiplication, and division
  • special arithmetic
    • percent (mod/remainder)
    • factorial
    • factors & shared factors
    • fraction simplification
    • square root (n)
  • infinite precision

Current limitations

  • cannot apply arithmetic to a HugeFloat with a HugeDecimal and another with a HugeRemainder, or vice versa
  • limited special arithmetic
    • no trigonometry, pi, square root remainder, log

Performance

Device

iMac19,1 - macOS 13.3.1 - Xcode 14.3 - Swift 5.8 - 1.47 TB free of 2TB - 3.6 GHz 8-Core i9 - 72 GB 2667 MHz DDR4 RAM

benchmark calculator located in huge_numbersTests

Compared to native

The tables below display the nanoseconds longer it took this library to calculate the result than native arithmetic.

*native calculation overflows; only compared to partial calculation

HugeInt

Version Scheme Left Number Right Number Addition Subtraction Multiplication Division
1.0.6 DEBUG 8237502387529357 397653549738 ~2,800 ~2,400 ~43,000* ~225,000
1.0.13 DEBUG 8237502387529357 397653549738 ~2,450 ~2,350 ~38,100* ~208,700
1.0.14 RELEASE 8237502387529357 397653549738 ~170 ~200 ~3,950* ~15,400
1.0.16 RELEASE 8237502387529357 397653549738 - - - ~4,450

HugeFloat

Version Scheme Precision Left Number Right Number Addition Subtraction Multiplication Division
1.0.6 DEBUG 100 12345.678 54321.012 ~8,200 ~8,300 ~24,000 ~13,000,000
1.0.13 DEBUG 6 12345.678 54321.012 ~8,000 ~8,300 ~22,000 ~410,000
1.0.13 DEBUG 100 12345.678 54321.012 - - - ~9,306,000
1.0.14 RELEASE 6 12345.678 54321.012 ~790 ~1,080 ~3,300 ~39,500
1.0.14 RELEASE 100 12345.678 54321.012 - - - ~660,000
1.0.16 RELEASE 6 12345.678 54321.012 - - - ~33,400
1.0.16 RELEASE 100 12345.678 54321.012 - - - ~533,000

Contributing

Adding/improving functionality is always welcome, just make a PR.

Funding

Support the development of this project by sponsoring the developers.

License

Public Domain. Creative Commons Zero v1.0 Universal.