BigInteger.IComparable.CompareTo(Object) Metode

Definisi

Ruang nama:

System.Numerics

Rakitan:

System.Runtime.Numerics.dll

Membandingkan instans ini dengan objek tertentu dan mengembalikan bilangan bulat yang menunjukkan apakah nilai instans ini kurang dari, sama dengan, atau lebih besar dari nilai objek yang ditentukan.

 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

Parameter

obj

Object

Objek yang akan dibandingkan.

Mengembalikan

Int32

Bilangan bulat bertanda tangan yang menunjukkan hubungan instans saat ini dengan obj parameter , seperti yang ditunjukkan dalam tabel berikut.

Mengembalikan nilai	Deskripsi
Kurang dari nol	Instans saat ini kurang dari obj.
Nol	Instans objsaat ini sama dengan .
Lebih besar dari nol	Instans saat ini lebih besar dari obj, atau parameternya obj adalah null.

Penerapan

CompareTo(Object)

Pengecualian

ArgumentException

objbukan .BigInteger

Contoh

Contoh berikut memanggil CompareTo(Object) metode untuk membandingkan BigInteger nilai dengan setiap elemen dalam array objek:

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

Keterangan

Parameter obj harus salah satu dari yang berikut ini:

• Objek yang jenis run-time-nya adalah BigInteger.

• Variabel Object yang nilainya adalah null. Jika nilai obj parameter adalah null, metode mengembalikan 1, yang menunjukkan bahwa instans saat ini lebih besar dari obj.

Lihat juga

• CompareTo(Object)