mdanok / roman-numbers

Converts roman numbers to arabic (and vice versa)

Roman Numbers

A simple package to convert roman to arabic numbers (and vice versa). It also can check valid roman format.

Installation

$ npm install --save roman-numbers

How to use it

Fist of all you can require it as follow:

const {romanToArab, arabToRoman, isValidArab, isValidRoman} = require('roman-numbers')

isValidArab

Checks if given value can be converted to roman. Only integers (it checks the type) from 1 to 3999 are valid values.

isValidArab(0) //Returns false
isValidArab(100) //Returns true
isValidArab('X') //Returns false

isValidRoman

Checks if given value can be converted to arab. Only capitalized strings with a valid roman format are valid values.

isValidRoman('') //Returns false
isValidRoman('IIIX') //Returns false
isValidRoman('ix') //Returns false
isValidArab('XI') //Returns true

romanToArab

Converts valid roman number to arab.

romanToArab('IX') //Returns 9
romanToArab('MMM') //Returns 3000
romanToArab('IIIX') //Returns NaN
romanToArab(1) //Returns NaN
romanToArab(0) //Returns NaN
romanToArab('') //Returns NaN

arabToRoman

Converts valid roman number to arab.

arabToRoman(12) //Returns 'XII'
arabToRoman(201) //Returns 'CCI'
arabToRoman(0) //Returns ''
arabToRoman('B') //Returns ''
arabToRoman('') //Returns ''
arabToRoman('5000') //Returns ''