TL.NumericExtensionsLibrary 0.4.2

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. .NET Standard 2.0 This package targets .NET Standard 2.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package TL.NumericExtensionsLibrary --version 0.4.2
                    


                    

                
NuGet\Install-Package TL.NumericExtensionsLibrary -Version 0.4.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="TL.NumericExtensionsLibrary" Version="0.4.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="TL.NumericExtensionsLibrary" Version="0.4.2" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="TL.NumericExtensionsLibrary" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add TL.NumericExtensionsLibrary --version 0.4.2
                    


                    

                
#r "nuget: TL.NumericExtensionsLibrary, 0.4.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package TL.NumericExtensionsLibrary@0.4.2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=TL.NumericExtensionsLibrary&version=0.4.2
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=TL.NumericExtensionsLibrary&version=0.4.2
                    


                            Install as a Cake Tool

🔢 TL.NumericExtensionsLibrary

NuGet .NET License: MIT

Lightweight numeric helpers for C#: value clamping, percentage calculations, and fluent math utilities for domain models and business logic.
Utilitários numéricos leves para C#: clamping (limites) de valores, cálculo de porcentagens e métodos matemáticos fluentes para regras de negócio.

O TL.NumericExtensionsLibrary fornece uma suíte completa de métodos de extensão matemáticos, estatísticos e de conversão para tipos primitivos (int, double e decimal), com foco em zero alocação, previsibilidade de domínio e alta precisão para cenários financeiros e computação numérica.

📦 Instalação

Adicione o pacote ao seu projeto através do .NET CLI:

dotnet add package TL.NumericExtensionsLibrary

🚀 Funcionalidades Principais

Extensões para int

Método Retorno Descrição
IsPrime() bool Valida se o número inteiro é primo.
IsEven() / IsOdd() bool Determina se o número é par ou ímpar.
Factorial() int Calcula o fatorial com validação de limites de representação.
IsPerfectSquare() bool Verifica se o número é um quadrado perfeito.
IsMultipleOf(divisor) bool Verifica se o número é múltiplo do divisor informado.
DigitSum() int Calcula a soma absoluta de todos os algarismos.
ReverseDigits() int Inverte a ordem dos algarismos do número.
GreatestCommonDivisor(b) int Calcula o Máximo Divisor Comum (MDC / GCD).
GreatestCommonMultiple(b) int Calcula o Mínimo Múltiplo Comum (MMC / LCM).
ToBinaryString() string Converte o número para representação binária textual.
ToHexString() string Converte o número para representação hexadecimal.

Extensões para double

Método Retorno Descrição
ToRadians() double Converte valores em graus para radianos.
ToDegrees() double Converte valores em radianos para graus.
IsEven() / IsOdd() bool Validação de paridade sobre a porção inteira do número.

Extensões para decimal

Método Retorno Descrição
Percentage(percentage) decimal Calcula percentual mantendo exatidão de ponto fixo financeiro.
WeightedAverage(numbers, weights) decimal Calcula a média ponderada entre valores e pesos correspondentes.
DigitSum() int Soma absoluta dos algarismos presentes no valor decimal.
ReverseDigits() decimal Inverte os algarismos da porção numérica.
Subtract(subtrahend) decimal Subtração fluente com suporte a encadeamento de chamadas.

💡 Exemplos de Uso

using NumericExtensionLibrary;

public class CalculadoraFinanceira
{
    public void ExecutarExemplos()
    {
        // 1. Cálculos de Teoria dos Números
        int numero = 17;
        bool primo = numero.IsPrime(); // true
        int somaDigitos = 12345.DigitSum(); // 15
        int mdc = 24.GreatestCommonDivisor(36); // 12

        // 2. Cálculos Financeiros em Ponto Fixo
        decimal valorBase = 1500.00m;
        decimal desconto = valorBase.Percentage(10); // 150.00m
        decimal totalLiquido = valorBase.Subtract(desconto); // 1350.00m
    }
}

🏛️ Decisões Arquiteturais

Para detalhes sobre o rigor matemático, prevenção contra estouros aritméticos e generic math, consulte:

📄 Licença

Distribuído sob a licença MIT.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • .NETStandard 2.0

    • No dependencies.

  • net8.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on TL.NumericExtensionsLibrary:

Package Downloads
TL.ExtensionLibrary.Domain

Clean Architecture Domain metapackage: pure, high-performance domain extensions (String, Numeric, DateTime, Enum, Collection) with zero external infrastructure dependencies.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.8.0 203 10/1/2026
0.7.0 195 9/26/2026
0.6.0 197 9/22/2026
0.5.0 205 9/16/2026
0.4.2 200 9/16/2026
0.4.1 210 9/11/2026
0.4.0 213 9/6/2026
0.3.0 121 9/6/2026
0.2.0 116 9/5/2026
0.1.0 122 9/4/2026
0.0.1 211 10/17/2024