BigInteger::Equals Method (BigInteger)


Returns a value that indicates whether the current instance and a specified BigInteger object have the same value.

Namespace:   System.Numerics
Assembly:  System.Numerics (in System.Numerics.dll)

virtual bool Equals(
	BigInteger other
) sealed


Type: System.Numerics::BigInteger

The object to compare.

Return Value

Type: System::Boolean

true if this BigInteger object and other have the same value; otherwise, false.

This method implements the IEquatable<T> interface and performs slightly better than Equals(Object^) because it does not have to convert the other parameter to a BigInteger object.

To determine the relationship between the two BigInteger objects instead of just testing for equality, call the BigInteger::CompareTo(BigInteger) method.

The following example compares the approximate distance of several stars from Earth with the distance of Epsilon Indi from Earth to determine whether they are equal. The example uses each overload of the Equals method to test for equality.

#using <System.Numerics.dll>

using namespace System;
using namespace System::Numerics;

void main()
   const Int64 LIGHT_YEAR = 5878625373183;

   BigInteger altairDistance = 17 * LIGHT_YEAR;
   BigInteger epsilonIndiDistance = 12 * LIGHT_YEAR;
   BigInteger ursaeMajoris47Distance = 46 * LIGHT_YEAR;
   Int64 tauCetiDistance = 12 * LIGHT_YEAR;
   UInt64 procyon2Distance = 12 * LIGHT_YEAR;
   Object^ wolf424ABDistance = 14 * LIGHT_YEAR;

   Console::WriteLine("Approx. equal distances from Epsilon Indi to:");
   Console::WriteLine("   Altair: {0}",
   Console::WriteLine("   Ursae Majoris 47: {0}",
   Console::WriteLine("   TauCeti: {0}",
   Console::WriteLine("   Procyon 2: {0}",
   Console::WriteLine("   Wolf 424 AB: {0}",
The example displays output like the following:
      Approx. equal distances from Epsilon Indi to:
      Altair: False
      Ursae Majoris 47: False
      TauCeti: True
      Procyon 2: True
      Wolf 424 AB: False

Universal Windows Platform
Available since 8
.NET Framework
Available since 4.0
Portable Class Library
Supported in: portable .NET platforms
Available since 4.0
Windows Phone
Available since 8.1
Return to top