BigInteger.IComparable.CompareTo(Object) Metoda

Definice

Obor názvů:

System.Numerics

Sestavení:

System.Runtime.Numerics.dll

Porovná tuto instanci se zadaným objektem a vrátí celé číslo, které označuje, zda je hodnota této instance menší než, rovna nebo větší než hodnota zadaného objektu.

 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

Objekt k porovnání

Návraty

Int32

Celé číslo se znaménkem, které označuje relaci aktuální instance k parametru obj , jak je znázorněno v následující tabulce.

Vrácená hodnota	Description
Menší než nula	Aktuální instance je menší než obj.
Žádnou	Aktuální instance se objrovná .
Větší než nula	Aktuální instance je větší než objnebo parametr obj je null.

Implementuje

CompareTo(Object)

Výjimky

ArgumentException

objnení .BigInteger

Příklady

Následující příklad volá metodu CompareTo(Object) pro porovnání BigInteger hodnoty s každým prvkem v poli objektů:

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

Poznámky

Parametr obj musí být jeden z následujících parametrů:

• Objekt, jehož typ za běhu je BigInteger.

• Proměnná Object , jejíž hodnota je null. Pokud je nullhodnota parametru obj , vrátí metoda hodnotu 1, což znamená, že aktuální instance je větší než obj.

Viz také

• CompareTo(Object)