MathF.Round Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

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 parzysnej.
Round(Single, Int32)	Zaokrągla wartość zmiennoprzecinkową o pojedynczej precyzji do określonej liczby cyfr ułamkowych i zaokrągla wartości punktu środkowego do najbliższej liczby parzystej.

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 do zaokrąglenie.

digits

Int32

Ile cyfr ułamkowych ma być zachowanych.

mode

MidpointRounding

Konwencja zaokrąglania do użycia.

Zwraca

Single

Zaokrąglona reprezentacja x z cyframi ułamkowymi digits przy użyciu konwencji zaokrąglania mode

Wyjątki

ArgumentOutOfRangeException

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

ArgumentException

mode nie 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 typ Single wynosi 6.

Ważny

Podczas zaokrąglania wartości punktu środkowego algorytm zaokrąglania wykonuje test równości. Ze względu na problemy z reprezentacją binarną i precyzją 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 jest Single.NaN, metoda zwraca wartość Single.NaN. Jeśli x jest Single.PositiveInfinity lub Single.NegativeInfinity, metoda zwraca odpowiednio Single.PositiveInfinity lub Single.NegativeInfinity.

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 do zaokrąglenie.

mode

MidpointRounding

Konwencja zaokrąglania do użycia.

Zwraca

Single

Zaokrąglona reprezentacja x przy użyciu konwencji zaokrąglania mode

Wyjątki

ArgumentException

mode nie jest prawidłową wartością MidpointRounding.

Uwagi

Ważny

Podczas zaokrąglania wartości punktu środkowego algorytm zaokrąglania wykonuje test równości. Ze względu na problemy z reprezentacją binarną i precyzją 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 jest Single.NaN, metoda zwraca wartość Single.NaN. Jeśli x jest Single.PositiveInfinity lub Single.NegativeInfinity, metoda zwraca odpowiednio Single.PositiveInfinity lub Single.NegativeInfinity.

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 parzysnej.

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 do zaokrąglenie.

Zwraca

Single

Zaokrąglona reprezentacja x

Uwagi

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

Ważny

Podczas zaokrąglania wartości punktu środkowego algorytm zaokrąglania wykonuje test równości. Ze względu na problemy z reprezentacją binarną i precyzją 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 jest Single.NaN, metoda zwraca wartość Single.NaN. Jeśli x jest Single.PositiveInfinity lub Single.NegativeInfinity, metoda zwraca odpowiednio Single.PositiveInfinity lub Single.NegativeInfinity.

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 metoda Round(Single) może nie wydawać się zaokrąglać wartości punktu środkowego do najbliższej parzystej liczby całkowitej.

Zobacz też

• Ceiling(Single)
• Floor(Single)

Round(Single, Int32)

Źródło:

MathF.cs

Zaokrągla wartość zmiennoprzecinkową o pojedynczej precyzji do określonej liczby cyfr ułamkowych i zaokrągla wartości punktu środkowego do najbliższej liczby parzystej.

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 do zaokrąglenie.

digits

Int32

Ile cyfr ułamkowych ma być zachowanych.

Zwraca

Single

Zaokrąglona reprezentacja x z cyframi ułamkowymi 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 typ Single.

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

Ważny

Podczas zaokrąglania wartości punktu środkowego algorytm zaokrąglania wykonuje test równości. Ze względu na problemy z reprezentacją binarną i precyzją 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 jest Single.NaN, metoda zwraca wartość Single.NaN. Jeśli x jest Single.PositiveInfinity lub Single.NegativeInfinity, metoda zwraca odpowiednio Single.PositiveInfinity lub Single.NegativeInfinity.

Zobacz też

• Ceiling(Single)
• Floor(Single)