MissingValues 2.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package MissingValues --version 2.0.0                
NuGet\Install-Package MissingValues -Version 2.0.0                
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="MissingValues" Version="2.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MissingValues --version 2.0.0                
#r "nuget: MissingValues, 2.0.0"                
#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.
// Install MissingValues as a Cake Addin
#addin nuget:?package=MissingValues&version=2.0.0

// Install MissingValues as a Cake Tool
#tool nuget:?package=MissingValues&version=2.0.0                

MissingValues numeric library for .Net 8+

MissingValues is a C# numeric library for C# that introduces support for large integers and higher precision floating-point numbers. It supports generic math.

Features

256-Bit and 512-Bit Integers

The library implements 256-bit and 512-bit integers, for both signed (Int256/Int512) and unsigned (UInt256/UInt512) integer arithmetic operations.

Here is a chart comparing the existing binary integers to the MissingValues integers:

Name Size Max Value Min Value
sbyte 8 bits 127 -128
byte 8 bits 255 0
short 16 bits 32,767 -32,768
ushort 16 bits 65,535 0
int 32 bits 2,147,483,647 -2,147,483,648
uint 32 bits 4,294,967,295 0
long 64 bits 9,223,372,036,854,775,807 -9,223,372,036,854,775,808
ulong 64 bits 18,446,744,073,709,551,615 0
Int128 128 bits 170,141,183,460,469,231,731,687,303,715,884,105,727 −170,141,183,460,469,231,731,687,303,715,884,105,728
UInt128 128 bits 340,282,366,920,938,463,463,374,607,431,768,211,455 0
Int256 256 bits 57,896,044,618,658,097,711,785,492,504,343,953,926,634,992,332,820,282,019,728,792,003,956,564,819,967 -57,896,044,618,658,097,711,785,492,504,343,953,926,634,992,332,820,282,019,728,792,003,956,564,819,968
UInt256 256 bits 115,792,089,237,316,195,423,570,985,008,687,907,853,269,984,665,640,564,039,457,584,007,913,129,639,935 0
Int512 512 bits 6,703,903,964,971,298,549,787,012,499,102,923,063,739,682,910,296,196,688,861,780,721,860,882,015,036,773,488,400,937,149,083,451,713,845,015,929,093,243,025,426,876,941,405,973,284,973,216,824,503,042,047 -6,703,903,964,971,298,549,787,012,499,102,923,063,739,682,910,296,196,688,861,780,721,860,882,015,036,773,488,400,937,149,083,451,713,845,015,929,093,243,025,426,876,941,405,973,284,973,216,824,503,042,048
UInt512 512 bits 13,407,807,929,942,597,099,574,024,998,205,846,127,479,365,820,592,393,377,723,561,443,721,764,030,073,546,976,801,874,298,166,903,427,690,031,858,186,486,050,853,753,882,811,946,569,946,433,649,006,084,095 0

Example Usage

using MissingValues; // namespace

// You can use the constructor:
Int256 num1 = new Int256(0x8000_0000_0000_0000, 0x0000_0000_0000_0000, 0x0000_0000_0000_0000, 0x0000_0000_0000_0001);
// You can use Parse():
Int256 num2 = Int256.Parse("10000000000000000000000000000000000000000000000000000000000000000000000000000");
// Or you can convert any other number type:
Int256 num3 = long.MaxValue;

// sum = -57896044618658097711785492504343953926634992332820282019728792003956564819967 + 10000000000000000000000000000000000000000000000000000000000000000000000000000 + 9223372036854775807
Int256 sum = num1 + num2 + num3;

Console.WriteLine($"Sum: {sum}");

// Prints: -47896044618658097711785492504343953926634992332820282019719568631919710044160

Quadruple-Precision and Octuple-Precision Floating-Point Number

The library introduces the Quad and Octo struct, representing a quadruple-precision floating-point and a octuple-precision floating-point number respectively. Quadruple-precision offers higher precision than standard double or float types, making it suitable for applications requiring extensive precision in numerical calculations.

Here is a chart comparing the existing IEEE floating point numbers to Quad:

Name Size Significand Digits Decimal Digits Max Exponent Min Exponent Max Value Min Value
Half 16 bits 11 3.31 15 -14 ~65504 ~-65500
Single 32 bits 24 7.22 127 -126 ~3.40e38 ~-3.40e38
Double 64 bits 53 15.95 1023 -1022 ~1.80e308 ~-1.79e308
Quad 128 bits 113 34.02 16383 -16382 ~1.19e4932 ~-1.18e4932
Octo 256 bits 237 71.34 262143 −262142 ~1.61e78913 ~-1.61e78913

Example Usage

using MissingValues; // namespace

// You can use the constructor:
Quad num1 = new Quad(sign: false, exp: 0x4004, sig: new UInt128(0x0000_9400_0000_0000, 0x0000_0000_0000_0000));
// You can use Parse():
Quad num2 = Quad.Parse("2e24");
// Or you can convert any other number type:
Quad num3 = 12.25d;

// sum = 50,5 + 2000000000000000000000000 + 12,25
Quad sum = num1 + num2 + num3;

Console.WriteLine($"Sum: {sum}");

// Prints 2000000000000000000000062,75
Product Compatible and additional computed target framework versions.
.NET 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net8.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.1.2 79 12/21/2024
2.1.1 87 12/21/2024 2.1.1 is deprecated because it has critical bugs.
2.1.0 93 11/15/2024
2.0.0 95 9/24/2024
1.2.3 137 2/2/2024
1.2.2 180 12/28/2023
1.2.1 137 12/26/2023
1.2.0 132 12/25/2023
1.1.0 174 11/10/2023
1.0.0 159 8/25/2023