BigInteger.Negate(BigInteger) メソッド

定義

指定された BigInteger 値を否定 (負数化) します。

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

パラメーター

value
BigInteger

否定する値。

戻り値

value パラメーターに -1 を乗算した結果。

次の例は、オブジェクトの値を否定する 3 つの方法を 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

注釈

否定は、数値の加法逆関数を取得します。 数値の加法逆関数は、元の数値に加算されるときに 0 の値を生成する数値です。

メソッドは Negate 、カスタム演算子をサポートしていない言語に対して実装されます。 その動作は、単項否定演算子を使用した否定と同じです。 さらに、 Negate メソッドは、次の例に示すように、変数をインスタンス化するときに BigInteger 否定演算子の代わりに役立ちます。

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

適用対象

こちらもご覧ください