CKTIS / C#
System.Func e FormattableString.Invariant: fechos e arredondamento
Fixe um argumento de um delegado por aplicação parcial, veja o que um fecho captura e separe o arredondamento decimal da formatação com cultura invariante.
Versão: C# 12 and .NET 8; later runtimes may add compatible features
Sintaxe
Func<decimal, int, decimal> round = static (value, digits) => Math.Round(value, digits, MidpointRounding.ToEven);
static Func<decimal, decimal> BindDigits(Func<decimal, int, decimal> operation, int digits) => value => operation(value, digits);
string text = FormattableString.Invariant($"{round(1.245m, 2):F2}");Em C# 12 e .NET 8, System.Func é uma família de tipos de delegados que devolvem um valor. O último argumento de tipo indica o tipo do resultado e os anteriores indicam os tipos dos parâmetros pela ordem da chamada. Func<TResult> não recebe parâmetros, Func<T, TResult> recebe um e Func<T1, T2, TResult> recebe dois. f(x) invoca um delegado com um parâmetro; atribuir uma expressão lambda não a executa.
A aplicação parcial fixa alguns argumentos e devolve uma função que aceita os restantes. C# não faz isto automaticamente: BindDigits devolve uma expressão lambda que captura os seus parâmetros operation e digits. A expressão lambda e as variáveis capturadas formam um fecho. A captura prolonga o tempo de vida da variável para além do seu âmbito léxico, mas não fixa o seu valor. BindDigits recebe o seu próprio parâmetro digits por valor, pelo que voltar a atribuir um valor a digits no código chamador não altera fixedRound. Já liveRound captura diretamente a variável do chamador e lê o seu valor atual. Uma expressão lambda static não pode capturar variáveis locais nem estado da instância.
System.Math.Round(decimal, int, MidpointRounding) devolve um decimal. Com MidpointRounding.ToEven, escolhe o valor mais próximo à precisão pedida. Exatamente a meio, escolhe aquele cujo último algarismo mantido é par: com duas casas decimais, 1.245m passa a 1.24m e 1.255m passa a 1.26m. Math.Round(decimal, int) usa a mesma regra por omissão. O sufixo m indica literais decimal, não double, cuja representação binária pode afetar a deteção do ponto médio. Um número de casas fora do intervalo 0–28 lança ArgumentOutOfRangeException; um valor de modo inválido lança ArgumentException.
O método estático System.FormattableString.Invariant(FormattableString) devolve uma string formatada com CultureInfo.InvariantCulture; um argumento null lança ArgumentNullException. Passe $"…" diretamente ou atribua-o primeiro a FormattableString: as expressões são avaliadas ao criar o objeto, que conserva o modelo de formatação e os argumentos avaliados. Atribuir primeiro a interpolação a string formata-a normalmente com a cultura atual, sem guardar o modelo nem os argumentos para voltar a formatar. Aqui, F2 apresenta duas casas decimais; não substitui a regra de arredondamento, não escapa dados de forma segura nem define um formato de serialização completo.
Exemplos
using System;
Func<decimal, int, decimal> round = static (value, digits) =>
Math.Round(value, digits, MidpointRounding.ToEven);
int digits = 2;
Func<decimal, decimal> fixedRound = BindDigits(round, digits);
Func<decimal, decimal> liveRound = value => round(value, digits);
digits = 1;
Console.WriteLine(FormattableString.Invariant(
$"fixed={fixedRound(1.245m):F2}; {fixedRound(1.255m):F2}"));
Console.WriteLine(FormattableString.Invariant($"live={liveRound(1.245m):F2}"));
static Func<decimal, decimal> BindDigits(
Func<decimal, int, decimal> operation, int digits) =>
value => operation(value, digits);Resultado
fixed=1.24; 1.26 live=1.20
`fixedRound` continua a arredondar a duas casas decimais, enquanto `liveRound` passa a arredondar a uma. `F2` apresenta `1.20` embora `liveRound` devolva `1.2m`; o ponto decimal vem da cultura invariante.
Lições relacionadas
- C# · Lição 49 · Avançado · Versão: 3
Fontes
- Func<TResult> Delegate (System)
- Func<T,TResult> Delegate (System)
- Func<T1,T2,TResult> Delegate (System)
- Lambda expressions and anonymous functions
- FormattableString.Invariant(FormattableString) Method (System)
- String interpolation using `$`
- Best practices for displaying and persisting formatted data in .NET
- Math.Round Method (System)
- MidpointRounding Enum (System)