MathF.Round Metoda

Definicja

Przeciążenia

Round(Single, Int32, MidpointRounding)

Zaokrągla wartość zmiennoprzecinkową o pojedynczej precyzji do określonej liczby cyfr ułamkowych przy użyciu określonej konwencji zaokrąglania.

Round(Single, MidpointRounding)

Zaokrągla wartość zmiennoprzecinkową o pojedynczej precyzji do liczby całkowitej przy użyciu określonej konwencji zaokrąglania.

Round(Single)

Zaokrągla wartość zmiennoprzecinkową o pojedynczej precyzji do najbliższej wartości całkowitej i zaokrągla wartości punktu środkowego do najbliższej liczby parzysta.

Round(Single, Int32)

Zaokrągla wartość zmiennoprzecinkowa o pojedynczej precyzji do określonej liczby cyfr ułamkowych i zaokrągla wartości punktów środkowych do najbliższej liczby parzysta.

Round(Single, Int32, MidpointRounding)

Zaokrągla wartość zmiennoprzecinkową o pojedynczej precyzji do określonej liczby cyfr ułamkowych przy użyciu określonej konwencji zaokrąglania.

public:
 static float Round(float x, int digits, MidpointRounding mode);
public static float Round (float x, int digits, MidpointRounding mode);
static member Round : single * int * MidpointRounding -> single
Public Shared Function Round (x As Single, digits As Integer, mode As MidpointRounding) As Single

Parametry

x
Single

Liczba zmiennoprzecinkowa o pojedynczej precyzji, która ma być zaokrąglona.

digits
Int32

Liczba cyfr ułamkowych w wartości zwracanej.

mode
MidpointRounding

Jedna z wartości wyliczenia, która określa, która strategia zaokrąglania ma być używana.

Zwraca

Single

Liczba zaokrąglona do tej liczby x ma digits cyfry ułamkowe. Jeśli x liczba cyfr ułamkowych jest mniejsza niż digits, x zwracana jest bez zmian.

Wyjątki

digits jest mniejsza niż 0 lub większa niż 6.

modenie jest prawidłową wartością .MidpointRounding

Uwagi

Wartość argumentu digits może wahać się od 0 do 6. Maksymalna liczba cyfr całkowitych i ułamkowych obsługiwanych przez Single typ wynosi 6.

Ważne

Podczas zaokrąglania wartości punktu środkowego algorytm zaokrąglania wykonuje test równości. Z powodu problemów z reprezentacją binarną i dokładnością w formacie zmiennoprzecinkowym wartość zwracana przez metodę może być nieoczekiwana. Aby uzyskać więcej informacji, zobacz Zaokrąglanie i precyzja.

Jeśli wartość argumentu x to Single.NaN, metoda zwraca Single.NaNwartość . Jeśli x metoda jest Single.PositiveInfinity lub Single.NegativeInfinity, metoda zwraca Single.PositiveInfinity wartość lub Single.NegativeInfinity, odpowiednio.

Zobacz też

Dotyczy

Round(Single, MidpointRounding)

Zaokrągla wartość zmiennoprzecinkową o pojedynczej precyzji do liczby całkowitej przy użyciu określonej konwencji zaokrąglania.

public:
 static float Round(float x, MidpointRounding mode);
public static float Round (float x, MidpointRounding mode);
static member Round : single * MidpointRounding -> single
Public Shared Function Round (x As Single, mode As MidpointRounding) As Single

Parametry

x
Single

Liczba zmiennoprzecinkowa o pojedynczej precyzji, która ma być zaokrąglona.

mode
MidpointRounding

Jedna z wartości wyliczenia, która określa, która strategia zaokrąglania ma być używana.

Zwraca

Single

Liczba całkowita x zaokrąglona do użycia mode konwencji zaokrąglania. Ta metoda zwraca typ Single całkowity zamiast typu całkowitego.

Wyjątki

modenie jest prawidłową wartością .MidpointRounding

Uwagi

Ważne

Podczas zaokrąglania wartości punktu środkowego algorytm zaokrąglania wykonuje test równości. Z powodu problemów z reprezentacją binarną i dokładnością w formacie zmiennoprzecinkowym wartość zwracana przez metodę może być nieoczekiwana. Aby uzyskać więcej informacji, zobacz Zaokrąglanie i precyzja.

Jeśli wartość argumentu x to Single.NaN, metoda zwraca Single.NaNwartość . Jeśli x metoda jest Single.PositiveInfinity lub Single.NegativeInfinity, metoda zwraca Single.PositiveInfinity wartość lub Single.NegativeInfinity, odpowiednio.

Zobacz też

Dotyczy

Round(Single)

Zaokrągla wartość zmiennoprzecinkową o pojedynczej precyzji do najbliższej wartości całkowitej i zaokrągla wartości punktu środkowego do najbliższej liczby parzysta.

public:
 static float Round(float x);
public static float Round (float x);
static member Round : single -> single
Public Shared Function Round (x As Single) As Single

Parametry

x
Single

Liczba zmiennoprzecinkowa o pojedynczej precyzji, która ma być zaokrąglona.

Zwraca

Single

Liczba całkowita najbliższa x. Jeśli część ułamkowa elementu x jest w połowie między dwiema liczbą całkowitą, z których jedna jest parzysta, a druga nieparzysta, zwracana jest liczba parzysta. Należy pamiętać, że ta metoda zwraca wartość Single zamiast typu całkowitego.

Uwagi

Ta metoda używa domyślnej konwencji zaokrąglania elementu MidpointRounding.ToEven.

Ważne

Podczas zaokrąglania wartości punktu środkowego algorytm zaokrąglania wykonuje test równości. Z powodu problemów z reprezentacją binarną i dokładnością w formacie zmiennoprzecinkowym wartość zwracana przez metodę może być nieoczekiwana. Aby uzyskać więcej informacji, zobacz Zaokrąglanie i precyzja.

Jeśli wartość argumentu x to Single.NaN, metoda zwraca Single.NaNwartość . Jeśli x metoda jest Single.PositiveInfinity lub Single.NegativeInfinity, metoda zwraca Single.PositiveInfinity wartość lub Single.NegativeInfinity, odpowiednio.

Uwagi dotyczące wywoływania

Ze względu na utratę dokładności, która może wynikać z reprezentowania wartości dziesiętnych jako liczb zmiennoprzecinkowych lub wykonywania operacji arytmetycznych na wartości zmiennoprzecinkowych, w niektórych przypadkach Round(Single) metoda może nie wydawać się zaokrąglać wartości punktów środkowych do najbliższej nawet liczby całkowitej.

Zobacz też

Dotyczy

Round(Single, Int32)

Zaokrągla wartość zmiennoprzecinkowa o pojedynczej precyzji do określonej liczby cyfr ułamkowych i zaokrągla wartości punktów środkowych do najbliższej liczby parzysta.

public:
 static float Round(float x, int digits);
public static float Round (float x, int digits);
static member Round : single * int -> single
Public Shared Function Round (x As Single, digits As Integer) As Single

Parametry

x
Single

Liczba zmiennoprzecinkowa o pojedynczej precyzji, która ma być zaokrąglona.

digits
Int32

Liczba cyfr ułamkowych w wartości zwracanej.

Zwraca

Single

Liczba najbliższa x , która zawiera liczbę cyfr ułamkowych równych digits.

Wyjątki

digits jest mniejsza niż 0 lub większa niż 6.

Uwagi

Wartość argumentu digits może wahać się od 0 do 6. Należy pamiętać, że 6 jest maksymalną liczbą cyfr całkowitych i ułamkowych obsługiwanych przez Single typ.

Ta metoda używa domyślnej konwencji zaokrąglania elementu MidpointRounding.ToEven.

Ważne

Podczas zaokrąglania wartości punktu środkowego algorytm zaokrąglania wykonuje test równości. Z powodu problemów z reprezentacją binarną i dokładnością w formacie zmiennoprzecinkowym wartość zwracana przez metodę może być nieoczekiwana. Aby uzyskać więcej informacji, zobacz Zaokrąglanie i precyzja.

Jeśli wartość argumentu x to Single.NaN, metoda zwraca Single.NaNwartość . Jeśli x metoda jest Single.PositiveInfinity lub Single.NegativeInfinity, metoda zwraca Single.PositiveInfinity wartość lub Single.NegativeInfinity, odpowiednio.

Zobacz też

Dotyczy