Tree3.Converter 3.0.0

Tree3.Converter

Tree3.Converter is a lightweight .NET library for converting between binary, decimal, octal and hexadecimal, supporting arbitrarily large numbers, input validation, and reusable utility methods.

Features

• Asynchronous API � all operations return Task<string>, ready for use in async workflows.
• Arbitrary-precision integer support � operands are passed as strings, enabling conversion with values larger than long limits.
• Simple, extensible interface � easy to implement with any numeric backend (e.g., BigInteger, external converter service, or distributed engine).
• Consistent method naming � unified API for converting between binary, decimal, octal and hexadecimal numbers.
• Serialization-friendly � string inputs/outputs integrate seamlessly with JSON APIs and network-based systems.
• Testable and mockable � ideal for dependency injection and unit testing scenarios.
• Cross-platform � built for .NET 10.0, works on Windows, Linux, and macOS.

Usage

using Tree3.Converter;

// All public interfaces and classes are in the Tree3.Converter namespace
ICustomBase64Converter
    Task<string> ToDecimalAsync(string number);

IBinaryConverter
	Task<string> ToDecimalAsync(string number);
	Task<string> ToOctalAsync(string number);
	Task<string> ToHexadecimalAsync(string number);

IConverterUtilities
	string RemoveLeadingZeros(string number);
	(bool, BigInteger) ParseDecimalToBigInteger(string number);
	(bool, BigInteger) ParseHexadecimalToBigInteger(string number);
	bool IsValidBinary(string number);
	bool IsValidDecimal(string number);
	bool IsValidOctal(string number);
	bool IsValidHexadecimal(string number);
	bool IsValidCustomBase64(string number);
	
IDecimalConverter
	Task<string> ToBinaryAsync(string number);
	Task<string> ToOctalAsync(string number);
	Task<string> ToHexadecimalAsync(string number);

IHexadecimalConverter
	Task<string> ToBinaryAsync(string number);
	Task<string> ToDecimalAsync(string number);
	Task<string> ToOctalAsync(string number);

IOctalConverter
	Task<string> ToBinaryAsync(string number);
	Task<string> ToDecimalAsync(string number);
	Task<string> ToHexadecimalAsync(string number);

// Custom Base64 Mapping Table
// Index:  0-9  => '0'-'9'
// Index:  10-35  => 'A'-'Z'
// Index:  36-61  => 'a'-'z'
// Index:     62  => '-'
// Index:     63  => '_'

Performance

NET 10 / Windows 11 / Intel i5 CPU

• Converts a binary number with 100,000 digits to decimal in ~0.5 seconds.

• Converts a binary number with 100,000 digits to octal in ~0.004 seconds.

• Converts a binary number with 100,000 digits to hexadecimal in ~0.6 seconds.

• Converts a decimal number with 100,000 digits to binary in ~7 seconds on.

• Converts a decimal number with 100,000 digits to octal in ~7 seconds on.

• Converts a decimal number with 100,000 digits to hexadecimal in ~0.01 seconds on.

• Converts a octal number with 100,000 digits to binary in ~0.01 seconds on.

• Converts a octal number with 100,000 digits to decimal in ~5 seconds on.

• Converts a octal number with 100,000 digits to hexadecimal in ~4.9 seconds on.

• Converts a hexadecimal number with 100,000 digits to binary in ~10 seconds on.

• Converts a hexadecimal number with 100,000 digits to decimal in ~1 seconds on.

• Converts a hexadecimal number with 100,000 digits to octal in ~10 seconds on.

• Converts a decimal number with 100,000 digits to base64 number in ~8 seconds on.

• Converts a base64 number with 100,000 digits to decimal in ~4 seconds on.

Release Notes

v3.0.0 � 2025-11-30

• Migrated to .NET 10.0.
• Added ICustomBase64Converter, IConverterUtilities
• New functionalities:
  • IDecimalConverter :
    • Task<string> ToBase64Async(string number);
  • ICustomBase64Converter :
    • Task<string> ToDecimalAsync(string number);
  • IConverterUtilities :
    • string RemoveLeadingZeros(string number);
    • (bool, BigInteger) ParseDecimalToBigInteger(string number);
    • (bool, BigInteger) ParseHexadecimalToBigInteger(string number);
    • bool IsValidBinary(string number);
    • bool IsValidDecimal(string number);
    • bool IsValidOctal(string number);
    • bool IsValidHexadecimal(string number);
    • bool IsValidCustomBase64(string number);

v2.0.0 � 2025-11-14

• Added IBinaryConverter, IDecimalConverter, IOctalConverter, IHexadecimalConverter interfaces for asynchronous non-negative integer conversion.
• Supported operations:
  • IBinaryConverter :
    • ToDecimalAsync(string number)
    • ToOctalAsync(string number)
    • ToHexadecimalAsync(string number)
  • IDecimalConverter :
    • ToBinaryAsync(string number)
    • ToOctalAsync(string number)
    • ToHexadecimalAsync(string number)
  • IOctalConverter :
    • ToBinaryAsync(string number)
    • ToDecimalAsync(string number)
    • ToHexadecimalAsync(string number)
  • IHexadecimalConverter :
    • ToBinaryAsync(string number)
    • ToDecimalAsync(string number)
    • ToOctalAsync(string number)
• All methods return results as string values, allowing support for very large numbers.
• Compatible with .NET 9.0.
• Designed for extensibility and dependency injection.

v1.1.0

• Refactored converter logic for performance and readability.
• Enhanced validation for decimal and binary inputs.
• Made all converter and validator classes static.
• Added reusable Utilities classes.