Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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.
Zalecana akcja
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
- Complex.Multiply(Complex, Complex)
- Complex.Division(Complex, Complex)
- Complex.Multiply(Complex, Complex)
- Complex.Divide(Complex, Complex)
- Complex.Reciprocal(Complex)
- Complex.Abs(Complex)
- Complex.Pow(Complex, Complex) i Complex.Pow(Complex, Double)
- Complex.Sqrt(Complex)
- Complex.Exp(Complex)
- Complex.Log(Complex) (wszystkie przeciążenia) i Complex.Log10(Complex)
- Complex.Sin(Complex), Complex.Cos(Complex), Complex.Tan(Complex), Complex.Sinh(Complex), Complex.Cosh(Complex), Complex.Tanh(Complex)
- Complex.Asin(Complex), Complex.Acos(Complex), Complex.Atan(Complex)