System.MidpointRounding, wyliczenie

  • Artykuł

Ten artykuł zawiera dodatkowe uwagi dotyczące dokumentacji referencyjnej dla tego interfejsu API.

MidpointRounding Użyj wyliczenia z odpowiednimi przeciążeniami Math.Round, MathF.RoundiDecimal.Round, aby zapewnić większą kontrolę nad procesem zaokrąglania.

Istnieją dwie ogólne strategie zaokrąglania — zaokrąglanie do najbliższego i ukierunkowanego zaokrąglania — a każde pole wyliczania bierze udział w dokładnie jednej z tych strategii.

Zaokrąglaj do najbliższej

Pola:

Operacja zaokrągla do najbliższej przyjmuje oryginalną liczbę z niejawną lub określoną precyzją; sprawdza następną cyfrę, która jest w tej precyzji i jedną; metoda zwraca najbliższą liczbę z taką samą dokładnością jak oryginalna liczba. W przypadku liczb dodatnich, jeśli następna cyfra wynosi od 0 do 4, najbliższa liczba jest w kierunku nieskończoności ujemnej. Jeśli następna cyfra wynosi od 6 do 9, najbliższa liczba jest w kierunku dodatniej nieskończoności. W przypadku liczb ujemnych, jeśli następna cyfra wynosi od 0 do 4, najbliższa liczba jest w kierunku dodatniej nieskończoności. Jeśli następna cyfra wynosi od 6 do 9, najbliższa liczba jest w kierunku nieskończoności ujemnej.

Jeśli następna cyfra wynosi od 0 do 4 lub 6 do 9, MidpointRounding.AwayFromZero wartość i MidpointRounding.ToEven nie ma wpływu na wynik operacji zaokrąglania. Jeśli jednak następna cyfra to 5, czyli punkt środkowy między dwoma możliwymi wynikami, a wszystkie pozostałe cyfry są zerowe lub nie ma pozostałych cyfr, najbliższa liczba jest niejednoznaczna. W takim przypadku tryby MidpointRounding zaokrąglone do najbliższego umożliwiają określenie, czy operacja zaokrąglania zwraca najbliższą liczbę od zera, czy najbliższą liczbę parzystą.

W poniższej tabeli przedstawiono wyniki zaokrąglania niektórych liczb ujemnych i dodatnich w połączeniu z trybami zaokrąglania do najbliższych. Precyzja używana do zaokrąglania liczb wynosi zero, co oznacza, że liczba po przecinku dziesiętnych wpływa na operację zaokrąglania. Na przykład dla liczby -2,5 cyfra po przecinku dziesiętnym wynosi 5. Ponieważ ta cyfra jest punktem środkowym MidpointRounding , można użyć wartości, aby określić wynik zaokrąglania. Jeśli AwayFromZero zostanie określony, zwracana jest wartość -3, ponieważ jest to najbliższa liczba z dala od zera z dokładnością do zera. Jeśli ToEven zostanie określony, zwracana jest wartość -2, ponieważ jest to najbliższa liczba parzysta z dokładnością do zera.

Oryginalna liczba AwayFromZero ToEven
3.5 4 4
2.8 3 3
2,5 3 2
2.1 2 2
-2.1 -2 -2
-2.5 –3 -2
-2.8 –3 –3
-3.5 -4 -4

Zaokrąglanie skierowane

Pola:

Operacja zaokrąglania skierowanego przyjmuje oryginalną liczbę z niejawną lub określoną precyzją i zwraca następną najbliższą liczbę w określonym kierunku z taką samą dokładnością jak liczba oryginalna. Tryby kierowane do MidpointRounding kontrolki, w kierunku której jest wykonywana wstępnie zdefiniowana liczba zaokrąglania.

W poniższej tabeli przedstawiono wyniki zaokrąglania niektórych liczb ujemnych i dodatnich w połączeniu z trybami zaokrąglania skierowanego. Precyzja używana do zaokrąglania liczb wynosi zero, co oznacza, że liczba przed przecinkowym punktem dziesiętna ma wpływ na operację zaokrąglania.

Oryginalna liczba ToNegativeInfinity ToPositiveInfinity ToZero
3.5 3 100 3
2.8 2 3 2
2,5 2 3 2
2.1 2 3 2
-2.1 –3 -2 -2
-2.5 –3 -2 -2
-2.8 –3 -2 -2
-3.5 -4 –3 –3