Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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