Arbitrary-precision decimal arithmetic with operator-overloaded, type-safe numbers; easy construction, conversions, comparisons, collection extensions, constants, accurate financial operations, and sample app demonstrating usage.
A Kotlin Multiplatform library providing arbitrary-precision decimal arithmetic across Android, iOS, and JVM platforms.
java.math.BigDecimal)java.math.BigDecimal)NSDecimalNumber)Add the dependency to your commonMain source set:
kotlin {
sourceSets {
commonMain.dependencies {
implementation("jp.co.tanocee:bikdecimal:1.0.0")
}
}
}
import jp.co.tanocee.bikdecimal.BikDecimal
val a = BikDecimal("123.45")
val b = BikDecimal("67.89")
val sum = a + b // 191.34
val difference = a - b // 55.56
val product = a * b // 8382.2205
val quotient = a / b // 1.818...
// From String
val fromString = BikDecimal("999.99")
// From Double
val fromDouble = BikDecimal(3.14159)
// From Long
val fromLong = BikDecimal(42L)
val zero = BikDecimal.ZERO // 0
val one = BikDecimal.ONE // 1
val x = BikDecimal("100")
val y = BikDecimal("200")
when {
x < y -> println("x is less than y")
x > y -> println("x is greater than y")
x == y -> println("x equals y")
}
// Or use compareTo directly
x.compareTo(y) // Returns negative, zero, or positive
val value = BikDecimal("123.456")
val asString = value.toPlainString() // "123.456"
val asDouble = value.toDouble() // 123.456
val asLong = value.toLong() // 123
valid = .toBikDecimal()
invalid = .toBikDecimal()
custom = .toBikDecimal(BikDecimal.ONE)
( name: String, price: String)
products = listOf(
Product(, ),
Product(, ),
Product(, )
)
total = products.sumOf { it.price.toBikDecimal() }
val value = BikDecimal("42.5")
val negated = value.negative() // -42.5
The sample module contains a Compose Multiplatform application demonstrating all features of BikDecimal. You can run it to see interactive examples of:
sumOfAndroid:
./gradlew :sample:assembleDebug
iOS:
Open the project in Xcode and run the sample target.
To build the library:
./gradlew :bikdecimal-core:build
To build the entire project including the sample app:
./gradlew build
commonMain - Common API and extension functionsandroidMain - Android implementation using java.math.BigDecimaljvmMain - JVM implementation using java.math.BigDecimaliosMain - iOS implementation using NSDecimalNumberSurfaced from shared tags and platforms — no rankings paid for.