BigInteger.IComparable.CompareTo(Object) Metoda

Definicja

Przestrzeń nazw:

System.Numerics

Zestaw:

System.Runtime.Numerics.dll

Porównuje to wystąpienie z określonym obiektem i zwraca liczbę całkowitą wskazującą, czy wartość tego wystąpienia jest mniejsza niż, równa lub większa niż wartość określonego obiektu.

 virtual int System.IComparable.CompareTo(System::Object ^ obj) = IComparable::CompareTo;

int IComparable.CompareTo (object obj);

abstract member System.IComparable.CompareTo : obj -> int
override this.System.IComparable.CompareTo : obj -> int

Function CompareTo (obj As Object) As Integer Implements IComparable.CompareTo

Parametry

obj

Object

Obiekt do porównania.

Zwraca

Int32

Podpisana liczba całkowita wskazująca relację bieżącego wystąpienia z parametrem obj , jak pokazano w poniższej tabeli.

Wartość zwracana	Opis
Mniej niż zero	Bieżące wystąpienie jest mniejsze niż obj.
Zero	Bieżące wystąpienie jest równe obj.
Większe od zera	Bieżące wystąpienie jest większe niż obj, lub obj parametr to null.

Implementuje

CompareTo(Object)

Wyjątki

ArgumentException

obj nie jest elementem BigInteger.

Przykłady

Poniższy przykład wywołuje metodę CompareTo(Object)BigInteger w celu porównania wartości z każdym elementem w tablicy obiektów:

object[] values = { BigInteger.Pow(Int64.MaxValue, 10), null,
                    12.534, Int64.MaxValue, BigInteger.One };
BigInteger number = UInt64.MaxValue;

foreach (object value in values)
{
   try {
      Console.WriteLine("Comparing {0} with '{1}': {2}", number, value,
                        number.CompareTo(value));
   }
   catch (ArgumentException) {
      Console.WriteLine("Unable to compare the {0} value {1} with a BigInteger.",
                        value.GetType().Name, value);
   }
}
// The example displays the following output:
//    Comparing 18446744073709551615 with '4.4555084156466750133735972424E+189': -1
//    Comparing 18446744073709551615 with '': 1
//    Unable to compare the Double value 12.534 with a BigInteger.
//    Unable to compare the Int64 value 9223372036854775807 with a BigInteger.
//    Comparing 18446744073709551615 with '1': 1

Dim values() As Object = { BigInteger.Pow(Int64.MaxValue, 10), Nothing, 
                           12.534, Int64.MaxValue, BigInteger.One }
Dim number As BigInteger = UInt64.MaxValue

For Each value As Object In values
   Try
      Console.WriteLine("Comparing {0} with '{1}': {2}", number, value, 
                        number.CompareTo(value))
   Catch e As ArgumentException
      Console.WriteLine("Unable to compare the {0} value {1} with a BigInteger.",
                        value.GetType().Name, value)
   End Try                     
Next                                 
' The example displays the following output:
'    Comparing 18446744073709551615 with '4.4555084156466750133735972424E+189': -1
'    Comparing 18446744073709551615 with '': 1
'    Unable to compare the Double value 12.534 with a BigInteger.
'    Unable to compare the Int64 value 9223372036854775807 with a BigInteger.
'    Comparing 18446744073709551615 with '1': 1

Uwagi

Parametr obj musi być jednym z następujących elementów:

• Obiekt, którego typ czasu wykonywania to BigInteger.

• Zmienna Object , której wartość to null. Jeśli wartość parametru obj to null, metoda zwraca wartość 1, co oznacza, że bieżące wystąpienie jest większe niż obj.

Zobacz też

• CompareTo(Object)