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

Beispiele

Im folgenden Beispiel werden drei Möglichkeiten 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

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 den additiven Umgekehrten einer Zahl. Die additive Inverse einer Zahl ist eine Zahl, die den Wert 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 unter Verwendung des unären Negationsoperators. 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);

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

Gilt für:

Weitere Informationen

• UnaryNegation(BigInteger)