BigInteger.Negate(BigInteger) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Negiert einen angegebenen BigInteger-Wert.
public:
static System::Numerics::BigInteger Negate(System::Numerics::BigInteger value);public static System.Numerics.BigInteger Negate (System.Numerics.BigInteger value);static member Negate : System.Numerics.BigInteger -> System.Numerics.BigIntegerPublic Shared Function Negate (value As BigInteger) As BigIntegerParameter
- value
- BigInteger
Der zu negierende Wert.
Gibt zurück
Das Ergebnis des value-Parameters, multipliziert mit -1.
Beispiele
Im folgenden Beispiel werden drei Möglichkeiten veranschaulicht, den Wert eines BigInteger Objekts zu negieren.
BigInteger number = 12645002;
Console.WriteLine(BigInteger.Negate(number)); // Displays -12645002
Console.WriteLine(-number); // Displays -12645002
Console.WriteLine(number * BigInteger.MinusOne); // Displays -12645002
let number = 12645002I
printfn $"{BigInteger.Negate number}" // Displays -12645002
printfn $"{-number}" // Displays -12645002
printfn $"{number * BigInteger.MinusOne}" // Displays -12645002
Dim number As BigInteger = 12645002
Console.WriteLine(BigInteger.Negate(number)) ' Displays -12645002
Console.WriteLine(-number) ' Displays -12645002
Console.WriteLine(number * BigInteger.MinusOne) ' Displays -12645002
Hinweise
Die Negation erhält die additive Inverse einer Zahl. Die additive Inverse einer Zahl ist eine Zahl, die einen Wert von 0 erzeugt, wenn sie der ursprünglichen Zahl hinzugefügt wird.
Die Negate -Methode wird für Sprachen implementiert, die keine benutzerdefinierten Operatoren unterstützen. Sein Verhalten ist identisch mit der Negation mit dem Operator für die unäre Negation. Darüber hinaus ist die Negate -Methode ein nützlicher Ersatz für den Negationsoperator beim Instanziieren einer BigInteger Variablen, wie im folgenden Beispiel gezeigt.
// The statement
// BigInteger number = -Int64.MinValue;
// produces compiler error CS0220: The operation overflows at compile time in checked mode.
// The alternative:
BigInteger number = BigInteger.Negate(Int64.MinValue);
let number = BigInteger.Negate Int64.MinValue
' The statement
' Dim number As BigInteger = -Int64.MinValue
' produces compiler error BC30439: Constant expression not representable in type 'Long'.
' The alternative:
Dim number As BigInteger = BigInteger.Negate(Int64.MinValue)
