BigInteger.Negate(BigInteger) メソッド

定義

名前空間:

System.Numerics

アセンブリ:

System.Runtime.Numerics.dll

Source:

BigInteger.cs

指定された 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

否定する値。

戻り値

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

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

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

こちらもご覧ください

• UnaryNegation(BigInteger)