ExNumerlo provides a unified interface for rendering and parsing integers using over 50 different Unicode numeral systems.

It supports modern positional systems, historical additive and hybrid systems, and specialized mathematical representations.

Core Features

• Unified API: Use convert/2 for encoding, decoding, and cross-system conversion.
• Auto-Detection: Automatically identify the source numeral system when decoding strings.
• Broad Support: Coverage for dozens of scripts including CJK, Indic, African, and historical systems.
• Formatting: Support for custom separators (e.g., thousands separators) in positional systems.

Supported Systems

Modern Positional (Base-10)

:arabic, :arabic_indic, :extended_arabic_indic, :devanagari, :bengali, :gurmukhi, :gujarati, :oriya, :tamil, :sinhala, :telugu, :kannada, :malayalam, :thai, :lao, :tibetan, :burmese, :khmer, :mongolian, :adlam, :balinese, :chakma, :cham, :gunjala_gondi, :javanese, :kayah_li, :lepcha, :limbu, :masaram_gondi, :meetei_mayek, :modi, :mro, :n_ko, :new_tai_lue, :nyiakeng_puachue_hmong, :ol_chiki, :osmanya, :pahawh_hmong, :saurashtra, :sharada, :sora_sompeng, :sundanese, :tai_tham_hora, :tai_tham_tham, :takri, :tangsa, :tirhuta, :toto, :vai, :wancho, :warang_citi, :nag_mundari, :fullwidth

Historical and Specialized

• Additive: :roman (1-3999), :aegean, :attic, :egyptian, :brahmi
• Alphabetic (Letter) Numerals: :greek (1-9999), :armenian (1-9999), :hebrew (1-999), :cyrillic (1-9999)
• Sign-Value and Accounting: :arabic_abjad, :tamil_traditional, :sinhala_archaic, :kharosthi, :rumi, :siyaq_indic, :siyaq_ottoman
• Hybrid: :ethiopic, :han (Chinese/Japanese myriad-based)
• Positional (Non-Base-10): :mayan (Base-20), :kaktovik (Base-20), :cuneiform (Base-60), :duodecimal (Base-12)
• Programmer Bases: :binary (Base-2), :octal (Base-8), :hexadecimal (Base-16), :base32 (Base-32), :base36 (Base-36)
• Specialized: :han_positional, :suzhou, :rod, :math_bold, :math_double_struck, :math_monospace, :math_sans, :math_sans_bold

Usage Examples

Encoding

ExNumerlo.convert(123, to: :devanagari)
# {:ok, "१२३"}

ExNumerlo.convert(2026, to: :roman)
# {:ok, "MMXXVI"}

Decoding with Auto-Detection

ExNumerlo.convert("१२३", to: :integer)
# {:ok, 123}

ExNumerlo.convert("MMXXVI", to: :integer)
# {:ok, 2026}

Formatting with Separators

ExNumerlo.convert(1234567, to: :arabic, separator: ",")
# {:ok, "1,234,567"}

ExNumerlo.convert("1,234,567", to: :integer, separator: ",")
# {:ok, 1234567}