MathF.Round Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

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

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

Single

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

Exceções

ArgumentOutOfRangeException

digits é menor que 0 ou maior que 6.

ArgumentException

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

• Ceiling(Single)
• Floor(Single)

Round(Single, MidpointRounding)

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

Single

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

Exceções

ArgumentException

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

• Ceiling(Single)
• Floor(Single)

Round(Single)

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

Single

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

• Ceiling(Single)
• Floor(Single)

Round(Single, Int32)

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

Single

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

Exceções

ArgumentOutOfRangeException

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

• Ceiling(Single)
• Floor(Single)