Converter.NumberSystem 1.0.0

Converter.NumberSystem

A lightweight .NET library for converting numbers between different numeral systems with built-in validation.

Features

• Convert between:

  • Binary (Base 2)
  • Octal (Base 8)
  • Decimal (Base 10)
  • Hexadecimal (Base 16)

• Automatic input validation.

• Clean object-oriented design.

• Extensible architecture based on abstract classes.

• Simple and intuitive API.

Package Information

Installation

dotnet add package Converter.NumberSystem

Quick Start

using Metigator.NumberSystem;
using Metigator.NumberSystem.Models;

public class Program
{
    public static void Main(string[] args)
    {
        var dec = new DecimalSystem("10");

        var bin = dec.To(NumberBase.BINARY);
        var oct = dec.To(NumberBase.OCTAL);
        var hex = dec.To(NumberBase.HEXADECIMAL);

        Console.WriteLine($"({dec.Value})10 = ({bin}){(int)NumberBase.BINARY}");
        Console.WriteLine($"({dec.Value})10 = ({oct}){(int)NumberBase.OCTAL}");
        Console.WriteLine($"({dec.Value})10 = ({hex}){(int)NumberBase.HEXADECIMAL}");

        Console.ReadKey();
    }
}

Output

(10)10 = (1010)2
(10)10 = (12)8
(10)10 = (A)16

Creating Number Objects

The library provides dedicated classes for each supported numeral system.

var binary = new BinarySystem("1010");
var octal = new OctalSystem("12");
var decimalNumber = new DecimalSystem("10");
var hexadecimal = new HexadecimalSystem("A");

Validation

Every number is validated when the object is created.

Valid example:

var binary = new BinarySystem("1010");

Invalid example:

var binary = new BinarySystem("1020");

The library will throw an exception because the value contains digits that are not valid in the binary numeral system.

Conversion

Convert any supported number system to another using the To() method.

var binary = new BinarySystem("1010");

string decimalValue = binary.To(NumberBase.DECIMAL);
string octalValue = binary.To(NumberBase.OCTAL);
string hexadecimalValue = binary.To(NumberBase.HEXADECIMAL);

Supported Number Systems

Architecture

The library is built around an abstract base class that represents a numeral system.

Each implementation provides:

• Its base value.
• Validation rules.
• Conversion support.

Current implementations:

BinarySystem
OctalSystem
DecimalSystem
HexadecimalSystem

This design makes it easy to add support for additional numeral systems in future versions.

Example Conversions

Requirements

• .NET 8.0 or later

License

This project is licensed under the MIT License.

Author

Mouatez Abderraouf A.

Developed and maintained by Metigator.