MathF.Round Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Pacote:

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

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 simples para o valor inteiro mais próximo e arredonda os 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 simples para o número especificado de dígitos fracionários e arredonda os 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

Um número de ponto flutuante de precisão simples a ser arredondado.

digits

Int32

O número de dígitos fracionários no valor de retorno.

mode

MidpointRounding

Um dos valores de enumeração que especifica qual estratégia de arredondamento usar.

Retornos

Single

O número arredondado x para que tem digits dígitos fracionários. Se x tiver menos dígitos fracionários que digits, x será retornado inalterado.

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 digits argumento pode variar de 0 a 6. O número máximo de dígitos integrais e fracionários com suporte pelo Single tipo é 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 do 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 x argumento 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

Um número de ponto flutuante de precisão simples a ser arredondado.

mode

MidpointRounding

Um dos valores de enumeração que especifica qual estratégia de arredondamento usar.

Retornos

Single

O inteiro arredondado x para usar a mode convenção de arredondamento. Esse método retorna um Single em vez de um tipo integral.

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 do 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 x argumento 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 simples para o valor inteiro mais próximo e arredonda os 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

Um número de ponto flutuante de precisão simples a ser arredondado.

Retornos

Single

O inteiro mais próximo de x. Se o componente fracionário de x estiver entre dois inteiros, sendo um deles par e o outro ímpar, o número par será retornado. Observe que esse método retorna um Single em vez de um tipo integral.

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 do 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 x argumento 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 Round(Single) método pode não parecer arredondar valores de ponto médio para o inteiro par 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 simples para o número especificado de dígitos fracionários e arredonda os 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

Um número de ponto flutuante de precisão simples a ser arredondado.

digits

Int32

O número de dígitos fracionários no valor de retorno.

Retornos

Single

O número mais próximo de x que contém um número de dígitos fracionários igual a digits.

Exceções

ArgumentOutOfRangeException

digits é menor que 0 ou maior que 6.

Comentários

O valor do digits argumento 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 Single tipo.

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 do 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 x argumento 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)