SciNotation.NET 1.0.4

SciNotation.NET

A simple, zero-dependency .NET library providing extension methods to format numeric values and strings into human-readable scientific notation (mantissa � 10^exponent).

Features

• Universal support: works with string, double, float, decimal, and all integer types.
• Culture-aware: honors IFormatProvider for decimal separators and number formatting.
• Special values: gracefully handles 0, NaN, Infinity, -Infinity, and subnormal doubles.
• Configurable precision: specify the number of decimal places in the mantissa.

Installation

Install via the .NET CLI:

dotnet add package SciNotation.NET

Or via the Package Manager Console:

Install-Package SciNotation.NET

Usage

Formatting a Numeric Value

using SciNotation.NET;

class Program
{
    static void Main()
    {
        double value = 12345.6789;
        // Format with 4 decimal places in the mantissa
        string scientific = value.ToScientificNotation(decimals: 4);
        Console.WriteLine(scientific);
        // Output: "1.2346 � 10^4"
    }
}

Formatting a String Input

using SciNotation.NET;

string input = "0.00000123";
string result = input.ToScientificNotation(decimals: 2);
// result == "1.23 � 10^-6"

Culture-Specific Formatting

using System.Globalization;
using SciNotation.NET;

var culture = new CultureInfo("de-DE");
string result = (1234.56).ToScientificNotation(decimals: 2, provider: culture);
// result == "1,23 � 10^3"

API Reference

Building from Source

1. Clone the repository:

   git clone https://github.com/datzfain/SciNotation.NET.git
   cd SciNotation.NET/SciNotation.NET
   

2. Restore and build:

   dotnet restore
   dotnet build --configuration Release
   

Running Tests

Navigate to the test project and run:

cd SciNotation.NET.Tests
dotnet test --configuration Release

Contributing

Contributions are welcome! To contribute:

1. Fork the repository.
2. Create a new branch: git checkout -b feature/YourFeature.
3. Implement your changes and add tests.
4. Commit your work: git commit -m "Add feature X".
5. Push to your fork and open a Pull Request.

Please follow the existing code style and include unit tests for new functionality.

License

This project is licensed under the MIT License.

_{Maintained by datzfain. Feel free to open issues or PRs!}