MathF.Round Método

Definição

Sobrecargas

Round(Single, Int32, MidpointRounding)

Arredonda um valor de ponto flutuante de precisão única para um número especificado de dígitos fracionários usando a convenção de arredondamento especificada.

Round(Single, MidpointRounding)

Arredonda um valor de ponto flutuante de precisão única para um inteiro usando a convenção de arredondamento especificada.

Round(Single)

Arredonda um valor de ponto flutuante de precisão única para o valor integral mais próximo e arredonda valores de ponto médio para o número par mais próximo.

Round(Single, Int32)

Arredonda um valor de ponto flutuante de precisão única para um número especificado de dígitos fracionários e arredonda valores de ponto médio para o número par mais próximo.

Round(Single, Int32, MidpointRounding)

Origem:
MathF.cs
Origem:
MathF.cs
Origem:
MathF.cs

Arredonda um valor de ponto flutuante de precisão única para um número especificado de dígitos fracionários usando a convenção de arredondamento especificada.

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

Parâmetros

x
Single

O número a ser arredondado.

digits
Int32

Quantos dígitos fracionários devem ser mantidos.

mode
MidpointRounding

A convenção de arredondamento a ser usada.

Retornos

A representação arredondada de x com digits dígitos fracionários usando mode convenção de arredondamento

Exceções

digits é menor que 0 ou maior que 6.

mode não é um valor válido de MidpointRounding.

Comentários

O valor do argumento digits pode variar de 0 a 6. O número máximo de dígitos integrais e fracionários suportados pelo tipo Single é 6.

Importante

Ao arredondar valores de ponto médio, o algoritmo de arredondamento executa um teste de igualdade. Devido a problemas de representação binária e precisão no formato de ponto flutuante, o valor retornado pelo método pode ser inesperado. Para obter mais informações, consulte arredondamento e precisão.

Se o valor do argumento x for Single.NaN, o método retornará Single.NaN. Se x for Single.PositiveInfinity ou Single.NegativeInfinity, o método retornará Single.PositiveInfinity ou Single.NegativeInfinity, respectivamente.

Confira também

Aplica-se a

Round(Single, MidpointRounding)

Origem:
MathF.cs
Origem:
MathF.cs
Origem:
MathF.cs

Arredonda um valor de ponto flutuante de precisão única para um inteiro usando a convenção de arredondamento especificada.

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

Parâmetros

x
Single

O número a ser arredondado.

mode
MidpointRounding

A convenção de arredondamento a ser usada.

Retornos

A representação arredondada de x usando mode convenção de arredondamento

Exceções

mode não é um valor válido de MidpointRounding.

Comentários

Importante

Ao arredondar valores de ponto médio, o algoritmo de arredondamento executa um teste de igualdade. Devido a problemas de representação binária e precisão no formato de ponto flutuante, o valor retornado pelo método pode ser inesperado. Para obter mais informações, consulte arredondamento e precisão.

Se o valor do argumento x for Single.NaN, o método retornará Single.NaN. Se x for Single.PositiveInfinity ou Single.NegativeInfinity, o método retornará Single.PositiveInfinity ou Single.NegativeInfinity, respectivamente.

Confira também

Aplica-se a

Round(Single)

Origem:
MathF.cs
Origem:
MathF.cs
Origem:
MathF.cs

Arredonda um valor de ponto flutuante de precisão única para o valor integral mais próximo e arredonda valores de ponto médio para o número par mais próximo.

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

Parâmetros

x
Single

O número a ser arredondado.

Retornos

A representação arredondada de x

Comentários

Esse método usa a convenção de arredondamento padrão de MidpointRounding.ToEven.

Importante

Ao arredondar valores de ponto médio, o algoritmo de arredondamento executa um teste de igualdade. Devido a problemas de representação binária e precisão no formato de ponto flutuante, o valor retornado pelo método pode ser inesperado. Para obter mais informações, consulte arredondamento e precisão.

Se o valor do argumento x for Single.NaN, o método retornará Single.NaN. Se x for Single.PositiveInfinity ou Single.NegativeInfinity, o método retornará Single.PositiveInfinity ou Single.NegativeInfinity, respectivamente.

Notas aos Chamadores

Devido à perda de precisão que pode resultar da representação de valores decimais como números de ponto flutuante ou da execução de operações aritméticas em valores de ponto flutuante, em alguns casos, o método Round(Single) pode não parecer arredondar valores de ponto médio para o inteiro mais próximo.

Confira também

Aplica-se a

Round(Single, Int32)

Origem:
MathF.cs
Origem:
MathF.cs
Origem:
MathF.cs

Arredonda um valor de ponto flutuante de precisão única para um número especificado de dígitos fracionários e arredonda valores de ponto médio para o número par mais próximo.

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

Parâmetros

x
Single

O número a ser arredondado.

digits
Int32

Quantos dígitos fracionários devem ser mantidos.

Retornos

A representação arredondada de x com digits dígitos fracionários

Exceções

digits é menor que 0 ou maior que 6.

Comentários

O valor do argumento digits pode variar de 0 a 6. Observe que 6 é o número máximo de dígitos integrais e fracionários compatíveis com o tipo Single.

Esse método usa a convenção de arredondamento padrão de MidpointRounding.ToEven.

Importante

Ao arredondar valores de ponto médio, o algoritmo de arredondamento executa um teste de igualdade. Devido a problemas de representação binária e precisão no formato de ponto flutuante, o valor retornado pelo método pode ser inesperado. Para obter mais informações, consulte arredondamento e precisão.

Se o valor do argumento x for Single.NaN, o método retornará Single.NaN. Se x for Single.PositiveInfinity ou Single.NegativeInfinity, o método retornará Single.PositiveInfinity ou Single.NegativeInfinity, respectivamente.

Confira também

Aplica-se a