MathF.Round Método

Definição

Espaço de Nomes:

System

Assemblagens:

netstandard.dll, System.Runtime.dll

Sobrecargas

Name	Description
Round(Single, Int32, MidpointRounding)	Arredonda um valor de ponto flutuante de precisão simples 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 simples 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 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 simples para um número especificado de dígitos fracionários, e arredonda os valores do 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 simples 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

Número a arredondar.

digits

Int32

Quantos dígitos fracionários devo manter.

mode

MidpointRounding

A convenção de arredondamento a usar.

Devoluções

Single

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

Exceções

ArgumentOutOfRangeException

digits é inferior a 0 ou superior a 6.

ArgumentException

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

Observações

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

Importante

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

Se o valor do x argumento for Single.NaN, o método devolve Single.NaN. Se x for Single.PositiveInfinity ou Single.NegativeInfinity, o método devolve Single.PositiveInfinity ou Single.NegativeInfinity, respetivamente.

Ver também

• Ceiling(Single)
• Floor(Single)

Round(Single, MidpointRounding)

Origem:

MathF.cs

Arredonda um valor de ponto flutuante de precisão simples 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

Número a arredondar.

mode

MidpointRounding

A convenção de arredondamento a usar.

Devoluções

Single

A representação arredondada de x usar mode a convenção de arredondamento

Exceções

ArgumentException

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

Observações

Importante

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

Se o valor do x argumento for Single.NaN, o método devolve Single.NaN. Se x for Single.PositiveInfinity ou Single.NegativeInfinity, o método devolve Single.PositiveInfinity ou Single.NegativeInfinity, respetivamente.

Ver também

• Ceiling(Single)
• Floor(Single)

Round(Single)

Origem:

MathF.cs

Arredonda um valor de ponto flutuante de precisão simples 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

Número a arredondar.

Devoluções

Single

A representação arredondada de x

Observações

Este método utiliza a convenção de arredondamento padrão de MidpointRounding.ToEven.

Importante

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

Se o valor do x argumento for Single.NaN, o método devolve Single.NaN. Se x for Single.PositiveInfinity ou Single.NegativeInfinity, o método devolve Single.PositiveInfinity ou Single.NegativeInfinity, respetivamente.

Notas para Chamadores

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

Ver também

• Ceiling(Single)
• Floor(Single)

Round(Single, Int32)

Origem:

MathF.cs

Arredonda um valor de ponto flutuante de precisão simples para um número especificado de dígitos fracionários, e arredonda os valores do 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

Número a arredondar.

digits

Int32

Quantos dígitos fracionários devo manter.

Devoluções

Single

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

Exceções

ArgumentOutOfRangeException

digits é inferior a 0 ou superior a 6.

Observações

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

Este método utiliza a convenção de arredondamento padrão de MidpointRounding.ToEven.

Importante

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

Se o valor do x argumento for Single.NaN, o método devolve Single.NaN. Se x for Single.PositiveInfinity ou Single.NegativeInfinity, o método devolve Single.PositiveInfinity ou Single.NegativeInfinity, respetivamente.

Ver também

• Ceiling(Single)
• Floor(Single)