core-common/org.meshtastic.core.common.util/NumberFormatter

NumberFormatter

object NumberFormatter(source)

Pure Kotlin number formatting utility — no expect/actual needed.

Functions

format

fun format(value: Double, decimalPlaces: Int): String

Formats a double value with the specified number of decimal places.

fun format(value: Float, decimalPlaces: Int): String

Formats a float value with the specified number of decimal places.

isDecimalSeparator

fun isDecimalSeparator(char: Char): Boolean

True when char is a decimal mark reachable from a Decimal/DecimalSigned keyboard.

isPartialDecimal

fun isPartialDecimal(text: String): Boolean

True when text could still become a number as the user types — an empty field, a lone sign, or a trailing separator. A controlled field consults this after parseDecimalOrNull returns null, so transient input like - or -. survives on the way to -1.5 instead of snapping back to the last committed value.

parseDecimalOrNull

fun parseDecimalOrNull(text: String): Double?

Parses a user-entered decimal whose separator follows the keyboard locale — 48,21 on a comma locale, which String.toDoubleOrNull rejects. A lone separator is always the decimal mark; grouping is only recognised when more than one appears, in which case the last one is the decimal mark. Returns null for anything unparseable.