feat(challenges): add roman-numerals

2025-12-11 00:21:24 +01:00 · 2021-06-30 15:03:39 +02:00
parent 57950426d3
commit 213ae08fb3
90 changed files with 177 additions and 0 deletions
@@ -0,0 +1,45 @@
+# roman-numerals
+
+Created by [@Divlo](https://github.com/Divlo) on 30 June 2021.
+
+## Instructions
+
+The objective of this challenge is to create a function that translates a number into Roman numerals or the other way around.
+
+We will use the letters `I`, `V`, `X`, `L`, `C`, `D`, `M` to build the Roman numerals.
+
+Here are the rules for building a Roman numeral:
+
+- The numbers `1`, `2` and `3` are written respectively as `I`, `II` and `III`
+- The number `5` is written as `V`
+- The number `10` is written as `X`
+- The number `50` is written as `L`
+- The number `100` is written as `C`
+- The number `500` is written as `D`
+- The number `1000` is written as `M`
+- When writing two letters in a row, if the numerical value of the first is greater than the numerical value of the second, their numerical values are added. For example the number `6` is written `VI`. We add `V` (5) + `I` (1) = 6.
+- When writing two letters in a row, if the numerical value of the first is less than the numerical value of the second, the value of the first is subtracted from the second. For example the number `4` is written `IV`. We subtract `V` (5) - `I` (1) = 4.
+- Subtractions of values are limited to 2 letters only. For example we **cannot** write `8` while doing `IIX`. We must use the addition of letters like this `VIII`.
+- Therefore, the first ten numbers are written as `I`, `II`, `III`, `IV`, `V`, `VI`, `VII`, `VIII`, `IX`, `X` . Larger numbers follow the same pattern.
+- You can associate as many symbols as you want to write larger numbers, for example:
+  - `36` is written as `XXXVI`
+  - `42` is written as `XLII`
+  - `2448` is written as `MMCDXLVIII`.
+
+| Symbol | I | V | X  | L  | C   | D   | M    |
+|--------|---|---|----|----|-----|-----|------|
+| Value  | 1 | 5 | 10 | 50 | 100 | 500 | 1000 |
+
+### Input
+
+- **Line 1:** The string : `arabic to roman` or `roman to arabic` to determine how to convert the number
+- **Line 2:** The number to convert
+
+## Source
+
+- [Wikipedia - Roman numerals](https://en.wikipedia.org/wiki/Roman_numerals)
+- [Wikipedia - Arabic numerals](https://en.wikipedia.org/wiki/Arabic_numerals)
+
+## Examples
+
+See the `test` folder for examples of input/output.
@@ -0,0 +1,2 @@
+arabic to roman
+1
@@ -0,0 +1 @@
+I
@@ -0,0 +1,2 @@
+arabic to roman
+59
@@ -0,0 +1 @@
+LIX
@@ -0,0 +1,2 @@
+arabic to roman
+93
@@ -0,0 +1 @@
+XCIII
@@ -0,0 +1,2 @@
+arabic to roman
+99
@@ -0,0 +1 @@
+XCIX
@@ -0,0 +1,2 @@
+arabic to roman
+141
@@ -0,0 +1 @@
+CXLI
@@ -0,0 +1,2 @@
+arabic to roman
+163
@@ -0,0 +1 @@
+CLXIII
@@ -0,0 +1,2 @@
+arabic to roman
+369
@@ -0,0 +1 @@
+CCCLXIX
@@ -0,0 +1,2 @@
+arabic to roman
+402
@@ -0,0 +1 @@
+CDII
@@ -0,0 +1,2 @@
+arabic to roman
+575
@@ -0,0 +1 @@
+DLXXV
@@ -0,0 +1,2 @@
+arabic to roman
+911
@@ -0,0 +1 @@
+CMXI
@@ -0,0 +1,2 @@
+arabic to roman
+999
@@ -0,0 +1 @@
+CMXCIX
@@ -0,0 +1,2 @@
+arabic to roman
+2
@@ -0,0 +1 @@
+II
@@ -0,0 +1,2 @@
+arabic to roman
+1024
@@ -0,0 +1 @@
+MXXIV
@@ -0,0 +1,2 @@
+arabic to roman
+2751
@@ -0,0 +1 @@
+MMDCCLI
@@ -0,0 +1,2 @@
+arabic to roman
+3000
@@ -0,0 +1 @@
+MMM
@@ -0,0 +1,2 @@
+roman to arabic
+I
@@ -0,0 +1 @@
+1
@@ -0,0 +1,2 @@
+roman to arabic
+II
@@ -0,0 +1 @@
+2
@@ -0,0 +1,2 @@
+roman to arabic
+III
@@ -0,0 +1 @@
+3
@@ -0,0 +1,2 @@
+roman to arabic
+IV
@@ -0,0 +1 @@
+4
@@ -0,0 +1,2 @@
+roman to arabic
+V
@@ -0,0 +1 @@
+5
@@ -0,0 +1,2 @@
+roman to arabic
+VI
@@ -0,0 +1 @@
+6
@@ -0,0 +1,2 @@
+roman to arabic
+IX
@@ -0,0 +1 @@
+9
@@ -0,0 +1,2 @@
+arabic to roman
+3
@@ -0,0 +1 @@
+III
@@ -0,0 +1,2 @@
+roman to arabic
+XXVII
@@ -0,0 +1 @@
+27
@@ -0,0 +1,2 @@
+roman to arabic
+XLVIII
@@ -0,0 +1 @@
+48
@@ -0,0 +1,2 @@
+roman to arabic
+LIX
@@ -0,0 +1 @@
+59
@@ -0,0 +1,2 @@
+roman to arabic
+XCIII
@@ -0,0 +1 @@
+93
@@ -0,0 +1,2 @@
+roman to arabic
+XCIX
@@ -0,0 +1 @@
+99
@@ -0,0 +1,2 @@
+roman to arabic
+CXLI
@@ -0,0 +1 @@
+141
@@ -0,0 +1,2 @@
+roman to arabic
+CLXIII
@@ -0,0 +1 @@
+163
@@ -0,0 +1,2 @@
+roman to arabic
+CCCLXIX
@@ -0,0 +1 @@
+369
@@ -0,0 +1,2 @@
+roman to arabic
+CDII
@@ -0,0 +1 @@
+402
@@ -0,0 +1,2 @@
+roman to arabic
+DLXXV
@@ -0,0 +1 @@
+575
@@ -0,0 +1,2 @@
+arabic to roman
+4
@@ -0,0 +1 @@
+IV
@@ -0,0 +1,2 @@
+roman to arabic
+CMXI
@@ -0,0 +1 @@
+911
@@ -0,0 +1,2 @@
+roman to arabic
+CMXCIX
@@ -0,0 +1 @@
+999
@@ -0,0 +1,2 @@
+roman to arabic
+MXXIV
@@ -0,0 +1 @@
+1024
@@ -0,0 +1,2 @@
+roman to arabic
+MMDCCLI
@@ -0,0 +1 @@
+2751
@@ -0,0 +1,2 @@
+roman to arabic
+MMM
@@ -0,0 +1 @@
+3000
@@ -0,0 +1,2 @@
+arabic to roman
+5
@@ -0,0 +1 @@
+V
@@ -0,0 +1,2 @@
+arabic to roman
+6
@@ -0,0 +1 @@
+VI
@@ -0,0 +1,2 @@
+arabic to roman
+9
@@ -0,0 +1 @@
+IX
@@ -0,0 +1,2 @@
+arabic to roman
+27
@@ -0,0 +1 @@
+XXVII
@@ -0,0 +1,2 @@
+arabic to roman
+48
@@ -0,0 +1 @@
+XLVIII