BigInteger.Negate(BigInteger) Méthode

Définition

Espace de noms:

System.Numerics

Assembly:

System.Runtime.Numerics.dll

Source:

BigInteger.cs

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

BigInteger

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

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

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

Voir aussi

• UnaryNegation(BigInteger)