https://github.com/razvangolan/romanmathoperations

Perform arithmetic operations on Roman numerals without converting them into integers
https://github.com/razvangolan/romanmathoperations

csharp dotnet roman-numerals

Last synced: 4 months ago
JSON representation

Perform arithmetic operations on Roman numerals without converting them into integers

• Host: GitHub
• URL: https://github.com/razvangolan/romanmathoperations
• Owner: RazvanGolan
• License: mit
• Created: 2024-11-13T15:07:41.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-11-23T09:24:42.000Z (over 1 year ago)
• Last Synced: 2025-01-24T06:26:33.394Z (over 1 year ago)
• Topics: csharp, dotnet, roman-numerals
• Language: C#
• Homepage:
• Size: 138 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# RomanMathOperations

They say the Roman Empire fell because of political turmoil, but maybe it was just too hard to calculate battle logistics with numbers like `MMCMXCIX`. While we can't rewrite history, this project makes Roman math a little less daunting.



  



This is a C# project implementing arithmetic operations for Roman numerals **without converting them to integers**. It supports addition, subtraction, multiplication, and division, ensuring the rules and conventions of Roman numerals are strictly followed. The project also includes robust input validation and handles invalid or improperly formatted Roman numerals gracefully.

## Features

- **Arithmetic Operations**:

    - **Addition**: Combines two Roman numerals into their sum.

    - **Subtraction**: Computes the difference between two Roman numerals.

    - **Multiplication**: Multiply two Roman numerals.

    - **Division**: Divides one Roman numeral by another and provides both the quotient and remainder.

- **Converter**:

  - **ConvertRomanToDecimal**: Converts a Roman numeral string into its decimal (integer) equivalent.

  - **ConvertDecimalToRoman**: Converts a decimal number into its Roman numeral representation, supporting values greater than 4000 by repeating the character `M`.

- **Validation**:

  - Detects invalid characters in Roman numerals (valid characters are `I`, `V`, `X`, `L`, `C`, `D`, `M`).

  - Ensures input follows valid Roman numeral formatting rules (e.g., prevents invalid sequences like `XXXX`).

- **Custom Exceptions**:

    - `InvalidRomanCharacter`: Raised when an invalid character is found in a Roman numeral.

    - `InvalidRomanFormat`: Raised when Roman numerals are not formatted correctly.

    - `InvalidRomanSubtractionException`: Raised when attempting to subtract a larger number from a smaller one.

    - `ResultIsZeroException`: Raised when an operation results in zero, which did not exist in Roman numeral systems.

## Tests

**The project includes comprehensive unit tests covering**:

- Arithmetic operations (addition, subtraction, multiplication, and division).

- Validation of invalid characters and formats.

- Exception handling for invalid operations.

- Randomly generated test cases to ensure correct results for various operations and conversions between Roman numerals and decimal numbers.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.