WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

System.Func und FormattableString.Invariant: Closures und Rundung

Binde ein Argument durch partielle Anwendung, untersuche die von einer Closure erfassten Variablen und trenne decimal-Rundung von kulturunabhängiger Formatierung.

Version: C# 12 and .NET 8; later runtimes may add compatible features

Syntax

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}");

In C# 12 und .NET 8 ist System.Func eine Familie von Delegattypen mit Rückgabewert. Das letzte Typargument gibt den Ergebnistyp an, die vorherigen geben die Parametertypen in Aufrufreihenfolge an. Func<TResult> hat keinen Parameter, Func<T, TResult> hat einen und Func<T1, T2, TResult> hat zwei. f(x) ruft einen Delegaten mit einem Parameter auf; das Zuweisen eines Lambdaausdrucks führt ihn noch nicht aus.

Partielle Anwendung legt einige Argumente fest und liefert eine Funktion für die restlichen. C# macht das nicht automatisch: BindDigits gibt einen Lambdaausdruck zurück, der die Parameter operation und digits erfasst. Der Lambdaausdruck und die erfassten Variablen bilden eine Closure. Das Erfassen verlängert die Lebensdauer einer Variablen über ihren lexikalischen Gültigkeitsbereich hinaus, ohne ihren Wert einzufrieren. BindDigits erhält jedoch seinen eigenen Parameter digits als Wert. Eine spätere Zuweisung an digits im aufrufenden Code ändert daher fixedRound nicht. liveRound erfasst die Variable des aufrufenden Codes direkt und liest ihren aktuellen Wert. Ein static-Lambda kann weder lokale Variablen noch Instanzzustand erfassen.

System.Math.Round(decimal, int, MidpointRounding) liefert einen decimal-Wert. MidpointRounding.ToEven wählt den nächstgelegenen Wert bei der angegebenen Zahl an Nachkommastellen. Genau in der Mitte gewinnt der Wert, dessen letzte beibehaltene Ziffer gerade ist: Bei zwei Stellen wird 1.245m zu 1.24m und 1.255m zu 1.26m. Math.Round(decimal, int) verwendet dieselbe Regel standardmäßig. Das Suffix m kennzeichnet decimal- statt double-Literale; bei double kann die binäre Darstellung die Erkennung des Mittelpunkts beeinflussen. Eine Stellenzahl außerhalb von 0–28 löst ArgumentOutOfRangeException aus, ein ungültiger Moduswert ArgumentException.

Die statische Methode System.FormattableString.Invariant(FormattableString) liefert einen mit CultureInfo.InvariantCulture formatierten string; bei null löst sie ArgumentNullException aus. Übergib $"…" direkt oder weise den Ausdruck zuerst FormattableString zu: Die Ausdrücke werden beim Erzeugen des Objekts ausgewertet, das die Formatvorlage und die ausgewerteten Argumente behält. Eine vorherige Zuweisung an string formatiert normalerweise mit der aktuellen Kultur und bewahrt Vorlage und Argumente nicht zur erneuten Formatierung auf. F2 zeigt hier zwei Nachkommastellen an; es ersetzt weder die Rundungsregel noch sorgt es für sicheres Escaping oder ein vollständiges Serialisierungsformat.

Beispiele

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);

Ergebnis

fixed=1.24; 1.26
live=1.20

`fixedRound` rundet weiterhin auf zwei Stellen, `liveRound` jetzt auf eine. `F2` zeigt `1.20` an, obwohl `liveRound` `1.2m` zurückgibt. Der Dezimalpunkt stammt aus der kulturunabhängigen Formatierung.

Zugehörige Lektionen

  • C# · Lektion 49 · Fortgeschritten · Version: 3

Quellen