BigInteger.IComparable.CompareTo(Object) Methode

Definition

Namespace:

System.Numerics

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 oder größer als der Wert des angegebenen Objekts ist oder mit diesem übereinstimmt.

int IComparable.CompareTo (object obj);

Parameter

obj

Object

Das zu vergleichende Objekt.

Gibt zurück

Int32

Eine ganze Zahl mit Vorzeichen, die die Beziehung der aktuellen Instanz zum obj-Parameter angibt, wie in der folgenden Tabelle veranschaulicht.

Rückgabewert	BESCHREIBUNG
Kleiner als 0 (null)	Die aktuelle Instanz ist kleiner als obj.
Zero	Die aktuelle Instanz ist gleich obj.
Größer als 0 (null)	Die aktuelle Instanz ist größer als obj, oder der obj-Parameter ist null.

Implementiert

CompareTo(Object)

Ausnahmen

ArgumentException

obj ist keine 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

Hinweise

Der obj Parameter muss einer der folgenden Sein:

• Ein Objekt, dessen Laufzeittyp ist BigInteger.

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

Gilt für:

Weitere Informationen

• CompareTo(Object)