BigInteger.Negate(BigInteger) Methode

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.BigInteger

Public Shared Function Negate (value As BigInteger) As BigInteger

Parameter

Gibt zurück

Das Ergebnis des value Parameters multipliziert mit negativem (-1).

Beispiele

Im folgenden Beispiel werden drei Methoden zum Negieren des Werts eines BigInteger Objekts veranschaulicht.

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 ruft die additive Umkehrung einer Zahl ab. Das Additiv inverse einer Zahl ist eine Zahl, die einen Wert von Null erzeugt, wenn sie der ursprünglichen Zahl hinzugefügt wird.

Die Negate Methode wird für Sprachen implementiert, die keine benutzerdefinierten Operatoren unterstützen. Das Verhalten ist identisch mit der Negation mithilfe des Unary Negation-Operators. 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)

Weitere Informationen

• UnaryNegation(BigInteger)