[API Proposal]: MinSafeInteger and MaxSafeInteger constants for System.Single and System.Double

[scharnyw]

Background and motivation

I find it occasionally necessary to represent integral values with floating-point numeric types. Some reasons why this may be necessary include, but are not limited to:

1. Compatibility with legacy code
2. A need to represent infinities and/or NaN with integral values
3. Desire to use a single field to hold a value that could be integral or floating-point, depending on the scenario

In such cases it would be helpful to have the constants MinSafeInteger and MaxSafeInteger defined in the floating-point numeric types to know if an integral value could be represented safely in the given type. "Safely" in this context refers to the ability to represent integers exactly and to compare them correctly.

This proposal is identical in concept to the corresponding APIs in JavaScript.

API Proposal

namespace System;

public readonly struct Double
{
    public const double MinSafeInteger = -9007199254740991d; // -(2^53-1)
    public const double MaxSafeInteger = 9007199254740991d; // 2^53-1
}

public readonly struct Single
{
    public const double MinSafeInteger = -16777215f; // -(2^24-1)
    public const double MaxSafeInteger = 16777215f; // 2^24-1
}

API Usage

double value = ...;

if (value >= double.MinSafeInteger && value <= double.MaxSafeInteger)
{
    // value can safely be represented in double
}
else
{
    // nope
}

Alternative Designs

No response

Risks

No response

[dotnet-policy-service[bot]]

Tagging subscribers to this area: @dotnet/area-system-numerics See info in area-owners.md if you want to be subscribed.