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

Parameters

Retouren

Het resultaat van de value parameter vermenigvuldigd met een negatieve parameter (-1).

Voorbeelden

In het volgende voorbeeld ziet u drie manieren om de waarde van een BigInteger object te vernieten.

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

Opmerkingen

Negatie verkrijgt de additieve inverse van een getal. De additieve inverse van een getal is een getal dat een waarde van nul produceert wanneer deze wordt toegevoegd aan het oorspronkelijke getal.

De Negate methode wordt geïmplementeerd voor talen die geen ondersteuning bieden voor aangepaste operators. Het gedrag is identiek aan negatie met behulp van de unaire negatie-operator. Daarnaast is de Negate methode een handige vervanging voor de negatieoperator bij het instantiëren van een BigInteger variabele, zoals wordt weergegeven in het volgende voorbeeld.

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

Zie ook

• UnaryNegation(BigInteger)