MathF.Round Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Pakiet:

Microsoft.Bcl.Numerics v9.0.0-preview.3.24172.9

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)

Źródło:

MathF.cs

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

ArgumentOutOfRangeException

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

ArgumentException

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. Ze względu na problemy 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ż

• Ceiling(Single)
• Floor(Single)

Round(Single, MidpointRounding)

Źródło:

MathF.cs

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

ArgumentException

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. Ze względu na problemy 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ż

• Ceiling(Single)
• Floor(Single)

Round(Single)

Źródło:

MathF.cs

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. Ze względu na problemy 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ż

• Ceiling(Single)
• Floor(Single)

Round(Single, Int32)

Źródło:

MathF.cs

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

ArgumentOutOfRangeException

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. Ze względu na problemy 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ż

• Ceiling(Single)
• Floor(Single)