Wyniki wartości specjalnej System.Numerics.Complex są teraz zgodne z załącznikiem G C23

Complex Operatory arytmetyczne i funkcje matematyczne generują teraz wyniki dla wartości specjalnych (dla zer ze znakiem, nieskończoności i NaN) wymagane przez załącznik G normy C23 (zespolonej arytmetyki zgodnej z IEC 60559). Ponieważ Complex teraz deleguje większość implementacji do nowego typu Complex<double>, zgodna obsługa wartości specjalnych jest dzięki temu zachowana także w nim.

Wersja wprowadzona

.NET 11

Poprzednie zachowanie

Wcześniej w przypadku danych wejściowych niebędących liczbami skończonymi (i niektórych powodujących przepełnienie) funkcje arytmetyczne i elementarne Complex często zwracały (NaN, NaN) nawet wtedy, gdy ukierunkowana nieskończoność lub wynik ze znakiem były matematycznie odpowiednie.

using System.Numerics;

Complex.Atan(new Complex(double.PositiveInfinity, 1.0)); // (NaN, NaN)
Complex.Acos(new Complex(double.NegativeInfinity, double.NaN)); // (NaN, NaN)
Complex.Cosh(new Complex(double.PositiveInfinity, double.PositiveInfinity)); // (NaN, NaN)

// An infinite operand could collapse the product to NaN:
new Complex(double.PositiveInfinity, double.PositiveInfinity) * new Complex(1.0, 0.0); // (NaN, NaN)

Nowe zachowanie

Począwszy od .NET 11, te same dane wejściowe zwracają wartości specjalne z załącznika G normy C23.

using System.Numerics;

Complex.Atan(new Complex(double.PositiveInfinity, 1.0)); // (π/2, 0)
Complex.Acos(new Complex(double.NegativeInfinity, double.NaN)); // (NaN, +∞)
Complex.Cosh(new Complex(double.PositiveInfinity, double.PositiveInfinity)); // (+∞, NaN)

// An infinite operand now yields a directed infinity (Annex G.5.1 recovery):
new Complex(double.PositiveInfinity, double.PositiveInfinity) * new Complex(1.0, 0.0); // (+∞, +∞)

Podział przez zerowy dzielnik jest podobnie regulowany przez załącznik G: wynik jest skierowaną nieskończonością lub NaN dla 0/0. Na przykład (1, 0) / (0, 0) daje nieskończony składnik rzeczywisty, a nie w pełni wynik NaN.

Zmiana obejmuje operator *, , operator /MultiplyDivideReciprocalAbsPowi funkcje podstawowe (Sqrt, Exp, Log, Log10, i trygonometryczne, hiperboliczne i odwrotne funkcje trygonometryczne). Jednym przypadkiem, który załącznik G jawnie pozostawia nieokreślony, jest to, że znak składnika ilorazu o zerowej wartości z operator / również może się różnić.

Typ zmiany przełamującej

Ta zmiana jest zmianą behawioralną.

Przyczyna zmiany

Liczby zespolone wykraczają poza zakres samego IEEE 754, więc załącznik G normy C23 jest odpowiednią specyfikacją zachowania wartości specjalnych, które IEEE 754 implikuje dla operacji skalarnych, na których opiera się arytmetyka zespolona. Poprzednia implementacja zwrócona NaN dla wielu danych wejściowych, w których załącznik G wymaga skierowanej nieskończoności lub podpisanego wyniku, który jest zarówno niezgodny, jak i mniej przydatny dla podrzędnego kodu liczbowego, ponieważ stracił informacje o znaku lub kierunku, które niesie nieskończona wartość pośrednia. Nowy typ generyczny Complex<T> uczyniono zgodnym, a typ Complex dziedziczy tę zgodność dzięki delegowaniu.

Aby uzyskać więcej informacji, zobacz dotnet/runtime#131132.

Większość kodu korzysta z bardziej dokładnych wyników i nie wymaga żadnych zmian. Jeśli kod jawnie zależy od poprzednich (NaN, NaN) wyników dla danych wejściowych o specjalnej wartości, zaktualizuj go, aby oczekiwać wartości załącznika G. Taki kod może obejmować testy, które sprawdzają NaN dla operacji Complex na nieskończonościach, lub logikę, która traktuje wszelkie dane wejściowe niebędące liczbami skończonymi jako skutkujące wartością NaN.

Nie ma przełącznika zgodności, aby przywrócić poprzednie zachowanie.

Interfejsy API, których dotyczy problem