Teilen über


BigInteger.Negate(BigInteger) Methode

Definition

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.BigInteger
Public Shared Function Negate (value As BigInteger) As BigInteger

Parameter

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)

Gilt für:

Weitere Informationen