BigInteger.Negate(BigInteger) Metoda

Definice

Obor názvů:

System.Numerics

Sestavení:

netstandard.dll, System.Runtime.Numerics.dll

Zdroj:

BigInteger.cs

Neguje zadanou BigInteger hodnotu.

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

Parametry

value

BigInteger

Hodnota, jejíž negace má být vypočtena.

Návraty

BigInteger

Výsledek parametru value vynásobený záporným jedním (-1).

Příklady

Následující příklad ukazuje tři způsoby, jak negovat hodnotu objektu BigInteger .

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

Poznámky

Negace získá přídatnou inverzní funkci čísla. Přídatná inverzní funkce čísla je číslo, které při přidání k původnímu číslu vytvoří hodnotu nula.

Metoda je implementována Negate pro jazyky, které nepodporují vlastní operátory. Jeho chování je stejné jako negace pomocí unárního operátoru negace. Metoda je navíc Negate užitečnou náhradou operátoru negace při vytváření instance BigInteger proměnné, jak je znázorněno v následujícím příkladu.

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

Viz také

• UnaryNegation(BigInteger)