Funções em C#: Utilizando o Método Math.Round
- #C#
Entendendo sua importância
Em geral, quando estamos trabalhando com valores numéricos na programação, um fator importante a ser considerado é sua formatação. A função Math.Round() é um dos métodos aplicados para modelar números e suas precisões em casas decimais. Dessa forma, a manipulação dos números se torna mais prática e compreensível de acordo com o contexto utilizado.
Nesse artigo, serão abordados os conceitos, parâmetros e exemplos de como esse método pode ser usado através da linguagem C#.
Conceitos básicos do Math.Round()
O método Math.Round() tem como função arredondar número para o inteiro mais próximo ou, de acordo com os parâmetros utilizados, para um número com a quantidade de casas decimais especificadas. Sua sintaxe é:
Math.Round(value, precision, mode);
Parâmetros
Observando a sintaxe acima, podemos definir três parâmetros no método Math.Round(), sendo eles:
- value: número decimal que sofrerá as alterações do método;
- precision: precisão da escala decimal que será retornada;
- mode: especifica a característica que será utilizada para arredondar o value inserido.
Abaixo serão demonstrados exemplos de como o uso dos parâmetros pode afetar o resultado retornado pelo método.
Exemplos
Nos exemplos a seguir, será utilizada a variável "value" para armazenar o valor que será arredondado pelo método. Observe alguns cenários de como utilizar o Math.Round():
- Inserindo apenas o número que sofrerá as alterações do método:
double value = 123.45;
Console.WriteLine(Math.Round(value));
Saída:
123
Nota: Após declarar a variável que armazena o número decimal "123.45", é descrito o método Math.Round() que recebe esse valor. Então, é retornada a resposta "123". Isso ocorre, porque apenas adicionamos um parâmetro que serve para declarar o valor numérico que será arredondado. Portanto, por padrão, o método transformará o número decimal no inteiro mais próximo.
- Inserindo o número que sofrerá as alterações do método e a precisão das casas decimais:
double value = 123.45;
Console.WriteLine(Math.Round(value, 1));
Saída:
123.4
Nota: Diferente do primeiro código, nesse contexto, foi adicionado o segundo parâmetro que indica o número de casas decimais (1) que o número arredondado terá quando retornado pelo método. Logo, o número "123.45" foi arredondado para "123.4", que contém apenas uma casa decimal, conforme solicitado na linha de código.
- Adicionando o parâmetro "MidpointRounding.AwayFromZero":
double value = 123.45;
Console.WriteLine(Math.Round(value, 1, MidpointRounding.AwayFromZero));
Saída:
123.5
Nota: Por fim, além de utilizarmos o parâmetro de casas decimais, nesse bloco de código foi adicionado a informação "MidpointRounding.AwayFromZero" que é um parâmetro que altera a configuração de arredondamento do método e, por conseguinte, o valor de saída que também possui uma casa decimal teve seu valor arredondado para cima, retornando o número "123.5".
Conclusão
O método Math.Round() é bem útil quando estamos manipulando números e, diante de seus parâmetros, temos diversas possibilidades e usos para sua implementação no código.
Segue o link da documentação completa desse método: https://learn.microsoft.com/pt-br/dotnet/api/system.math.round?view=net-8.0
