BigInteger.Negate(BigInteger) Méthode

Définition

Rend négative la valeur BigInteger spécifiée.

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

Paramètres

value
BigInteger

Valeur à rendre négative.

Retours

Résultat de la multiplication du paramètre value par moins un (-1).

Exemples

L’exemple suivant illustre trois façons de nier la valeur d’un BigInteger objet.

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

Remarques

La négation obtient l’inverse additif d’un nombre. L’inverse additif d’un nombre est un nombre qui produit une valeur de zéro lorsqu’il est ajouté au nombre d’origine.

La Negate méthode est implémentée pour les langages qui ne prennent pas en charge les opérateurs personnalisés. Son comportement est identique à la négation à l’aide de l’opérateur de négation unaire. En outre, la Negate méthode est un substitut utile pour l’opérateur de négation lors de l’instanciation d’une BigInteger variable, comme illustré dans l’exemple suivant.

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

S’applique à

Voir aussi