BigInteger.Equality Operator

Definition

Returns a value that indicates whether two values are equal.

 Equality(Int64, BigInteger) Returns a value that indicates whether a signed long integer value and a BigInteger value are equal. Equality(BigInteger, Int64) Returns a value that indicates whether a BigInteger value and a signed long integer value are equal. Equality(BigInteger, BigInteger) Returns a value that indicates whether the values of two BigInteger objects are equal. Equality(BigInteger, UInt64) Returns a value that indicates whether a BigInteger value and an unsigned long integer value are equal. Equality(UInt64, BigInteger) Returns a value that indicates whether an unsigned long integer value and a BigInteger value are equal.

Equality(Int64, BigInteger)

Returns a value that indicates whether a signed long integer value and a BigInteger value are equal.

public:
static bool operator ==(long left, System::Numerics::BigInteger right);
public static bool operator == (long left, System.Numerics.BigInteger right);
static member ( = ) : int64 * System.Numerics.BigInteger -> bool
Public Shared Operator == (left As Long, right As BigInteger) As Boolean

Parameters

left
Int64

The first value to compare.

right
BigInteger

The second value to compare.

Returns

Boolean

true if the left and right parameters have the same value; otherwise, false.

Remarks

The Equality(Int64, BigInteger) method defines the equality comparison operation for BigInteger values. It enables code such as the following:

BigInteger bigNumber = BigInteger.Pow(2, 63);
long number = Int64.MaxValue;
if (number == bigNumber)
{
// Do something...
}
Dim bigNumber As BigInteger = BigInteger.Pow(2, 63)
Dim number As Long = Int64.MaxValue
If number = bigNumber Then
' Do something...
End If

Languages that do not support custom operators can call the BigInteger.Equals(Int64) instance method instead.

If left is a Byte, Int16, Int32, SByte, UInt16, or UInt32 value, it is implicitly converted to an Int64 value when the operation is performed.

The equivalent method for this operator is BigInteger.Equals(Int64).

Equality(BigInteger, Int64)

Returns a value that indicates whether a BigInteger value and a signed long integer value are equal.

public:
static bool operator ==(System::Numerics::BigInteger left, long right);
public static bool operator == (System.Numerics.BigInteger left, long right);
static member ( = ) : System.Numerics.BigInteger * int64 -> bool
Public Shared Operator == (left As BigInteger, right As Long) As Boolean

Parameters

left
BigInteger

The first value to compare.

right
Int64

The second value to compare.

Returns

Boolean

true if the left and right parameters have the same value; otherwise, false.

Remarks

The Equality(BigInteger, Int64) method defines the equality comparison operation for BigInteger values. It enables code such as the following:

BigInteger bigNumber = BigInteger.Pow(2, 63);
long number = Int64.MaxValue;
if (bigNumber == number)
{
// Do something...
}
Dim bigNumber As BigInteger = BigInteger.Pow(2, 63)
Dim number As Long = Int64.MaxValue
If bigNumber = number Then
' Do something...
End If

Languages that do not support custom operators can call the BigInteger.Equals(Int64) instance method instead.

If right is a Byte, Int16, Int32, SByte, UInt16, or UInt32 value, it is implicitly converted to an Int64 value when the operation is performed.

The equivalent method for this operator is BigInteger.Equals(Int64).

Equality(BigInteger, BigInteger)

Returns a value that indicates whether the values of two BigInteger objects are equal.

public:
static bool operator ==(System::Numerics::BigInteger left, System::Numerics::BigInteger right);
public static bool operator == (System.Numerics.BigInteger left, System.Numerics.BigInteger right);
static member ( = ) : System.Numerics.BigInteger * System.Numerics.BigInteger -> bool
Public Shared Operator == (left As BigInteger, right As BigInteger) As Boolean

Parameters

left
BigInteger

The first value to compare.

right
BigInteger

The second value to compare.

Returns

Boolean

true if the left and right parameters have the same value; otherwise, false.

Remarks

The Equality(BigInteger, BigInteger) method defines the operation of the equality operator for BigInteger values. It enables code such as the following:

BigInteger number1 = 945834723;
BigInteger number2 = 345145625;
BigInteger number3 = 945834723;
Console.WriteLine(number1 == number2);             // Displays False
Console.WriteLine(number1 == number3);             // Displays True
Dim number1 As BigInteger = 945834723
Dim number2 As BigInteger = 345145625
Dim number3 As BigInteger = 945834723
Console.WriteLine(number1 = number2)                  ' Displays False
Console.WriteLine(number1 = number3)                  ' Displays True

Languages that do not support custom operators can call the BigInteger.Equals(BigInteger) instance method instead.

The equivalent method for this operator is BigInteger.Equals(BigInteger).

Equality(BigInteger, UInt64)

Important

This API is not CLS-compliant.

Returns a value that indicates whether a BigInteger value and an unsigned long integer value are equal.

public:
static bool operator ==(System::Numerics::BigInteger left, System::UInt64 right);
[System.CLSCompliant(false)]
public static bool operator == (System.Numerics.BigInteger left, ulong right);
[<System.CLSCompliant(false)>]
static member ( = ) : System.Numerics.BigInteger * uint64 -> bool
Public Shared Operator == (left As BigInteger, right As ULong) As Boolean

Parameters

left
BigInteger

The first value to compare.

right
UInt64

The second value to compare.

Returns

Boolean

true if the left and right parameters have the same value; otherwise, false.

Attributes

Remarks

The Equality(BigInteger, UInt64) method defines the equality comparison operation for BigInteger values. It enables code such as the following:

BigInteger bigNumber = BigInteger.Pow(2, 63) - BigInteger.One;
ulong uNumber = Int64.MaxValue & 0x7FFFFFFFFFFFFFFF;
if (bigNumber == uNumber)
{
// Do something...
}
Dim bigNumber As BigInteger = BigInteger.Pow(2, 63) - BigInteger.One
Dim uNumber As ULong = CULng(Int64.MaxValue And CULng(&h7FFFFFFFFFFFFFFF))
If bigNumber = uNumber Then
' Do something...
End If

Languages that do not support custom operators can call the BigInteger.Equals(UInt64) instance method instead.

Equality(UInt64, BigInteger)

Important

This API is not CLS-compliant.

Returns a value that indicates whether an unsigned long integer value and a BigInteger value are equal.

public:
static bool operator ==(System::UInt64 left, System::Numerics::BigInteger right);
[System.CLSCompliant(false)]
public static bool operator == (ulong left, System.Numerics.BigInteger right);
[<System.CLSCompliant(false)>]
static member ( = ) : uint64 * System.Numerics.BigInteger -> bool
Public Shared Operator == (left As ULong, right As BigInteger) As Boolean

Parameters

left
UInt64

The first value to compare.

right
BigInteger

The second value to compare.

Returns

Boolean

true if the left and right parameters have the same value; otherwise, false.

Attributes

Remarks

The Equality(UInt64, BigInteger) method defines the equality comparison operation for BigInteger values. It enables code such as the following:

BigInteger bigNumber = BigInteger.Pow(2, 63) - BigInteger.One;
ulong uNumber = Int64.MaxValue & 0x7FFFFFFFFFFFFFFF;
if (uNumber == bigNumber)
{
// Do something...
}
Dim bigNumber As BigInteger = BigInteger.Pow(2, 63) - BigInteger.One
Dim uNumber As ULong = CULng(Int64.MaxValue And CULng(&h7FFFFFFFFFFFFFFF))
If uNumber = bigNumber Then
' Do something...
End If

Languages that do not support custom operators can call the BigInteger.Equals(UInt64) instance method instead.