Numero

Numero is a micro library for converting non-Western Arabic numerals, such as ۱ (Farsi), ۲ (Bengali), ۳ (Devanagari), ੪ (Gurmukhi), and ๕ (Thai), into Western Arabic numerals (1, 2, 3, 4, and 5, respectively). It also provides conversion into integer() and float() basic types.

Supported Languages / Scripts

All numbers defined in Unicode 16.0.0 as Nd (numeric digit) class are supported. For more information, see the Unicode specification chapter 4, Character Properties sections on General Category and Numeric Value.

The conversion routine is derived from DerivedNumericValues.txt.

Installation

Numero can be installed by adding numero to your list of dependencies in mix.exs:

def deps do
  [{:numero, "~> 0.5.0"}]
end

Using Numero

On strings for strings:

result = Numero.normalize("1۲۳۰4a۳tس")
# result = "12304a3tس"

Smart numeric convert:

(Convert numbers to Integer or Float based on input string)

result = Numero.normalize_as_number("1۲۳۰4۳")
# result = {:ok, 123043}

result = Numero.normalize_as_number("1۲۳۰4۳.۴5")
# result = {:ok, 123043.45}

result = Numero.normalize_as_number!("1۲۳۰4۳.۴5")
# result = 123043.45

Strip all non numeric chars from a string:

result = Numero.remove_non_digits("12 345abs")
# result = "12345"

# Or even make exceptions for some chars like 'a' and ' ' (space)
result = Numero.remove_non_digits("12 345bas", ~c[a ])
# result = "12 345a"

Checking if a string is all numbers

result = Numero.digit_only?("1234567890")
# result = true

result = Numero.digit_only?("1234567890.a")
# result = false