BigInteger.IComparable.CompareTo(Object) Methode

Definition

Namespace:
System.Numerics
Assemblys:
System.Numerics.dll, System.Runtime.Numerics.dll
Assembly:
System.Runtime.Numerics.dll

Vergleicht diese Instanz mit einem angegebenen Objekt und gibt eine ganze Zahl zurück, die angibt, ob der Wert dieser Instanz kleiner als, gleich oder größer als der Wert des angegebenen Objekts ist.

 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

Das zu vergleichende Objekt.

Gibt zurück

Int32

Eine signierte ganze Zahl, die die Beziehung der aktuellen Instanz zum obj Parameter angibt, wie in der folgenden Tabelle dargestellt.

Rückgabewert Description
Kleiner als null Die aktuelle Instanz ist kleiner als obj.
Null Die aktuelle Instanz ist gleich obj.
Größer als null Die aktuelle Instanz ist größer als obj, oder der obj Parameter ist null.

Implementiert

CompareTo(Object)

Ausnahmen

ArgumentException

obj ist kein BigInteger.

Beispiele

Im folgenden Beispiel wird die CompareTo(Object) Methode aufgerufen, um einen BigInteger Wert mit jedem Element in einem Objektarray zu vergleichen:

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

let values =
    [| BigInteger.Pow(Int64.MaxValue, 10)
       Unchecked.defaultof<bigint>
       bigint 12.534
       Int64.MaxValue
       BigInteger.One |]

let number = bigint UInt64.MaxValue

for value in values do
    try
        printfn $"Comparing {number} with '{value}': {number.CompareTo value}"
    with :? ArgumentException as e ->
        printfn $"Unable to compare the {value.GetType().Name} value {value} with a BigInteger."
// 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

Hinweise

Der obj Parameter muss eine der folgenden Sein:

  • Ein Objekt, dessen Laufzeittyp lautet BigInteger.

  • Eine Object Variable, deren Wert lautet null. Wenn der Wert des obj Parameters lautet null, gibt die Methode 1 zurück, was angibt, dass die aktuelle Instanz größer als objist.

Gilt für:

Weitere Informationen