BigInteger.IComparable.CompareTo(Object) Méthode

Définition

Compare cette instance à un objet spécifié et retourne un entier qui indique si la valeur de cette instance est inférieure, égale ou supérieure à la valeur de l'objet spécifié.Compares this instance to a specified object and returns an integer that indicates whether the value of this instance is less than, equal to, or greater than the value of the specified object.

 virtual int System.IComparable.CompareTo(System::Object ^ obj) = IComparable::CompareTo;
int IComparable.CompareTo (object obj);
Function CompareTo (obj As Object) As Integer Implements IComparable.CompareTo

Paramètres

obj
Object

Objet à comparer.The object to compare.

Retours

Entier signé qui indique la relation de l'instance actuelle par rapport au paramètre obj, comme indiqué dans le tableau suivant.A signed integer that indicates the relationship of the current instance to the obj parameter, as shown in the following table.

Valeur de retourReturn value DescriptionDescription
Inférieure à zéroLess than zero L'instance actuelle est inférieure à obj.The current instance is less than obj.
ZéroZero L'instance actuelle est égale à obj.The current instance equals obj.
Supérieure à zéroGreater than zero L'instance actuelle est supérieure à obj ou le paramètre obj est null.The current instance is greater than obj, or the obj parameter is null.

Implémente

Exceptions

obj n’est pas un BigInteger.obj is not a BigInteger.

Exemples

L’exemple suivant appelle la méthode CompareTo(Object) pour comparer une valeur BigInteger à chaque élément d’un tableau d’objets :The following example calls the CompareTo(Object) method to compare a BigInteger value with each element in an object array:

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

Remarques

Le paramètre obj doit avoir l’une des valeurs suivantes :The obj parameter must be one of the following:

  • Objet dont le type au moment de l’exécution est BigInteger.An object whose run-time type is BigInteger.

  • Variable Object dont la valeur est null.An Object variable whose value is null. Si la valeur du paramètre obj est null, la méthode retourne 1, ce qui indique que l’instance actuelle est supérieure à obj.If the value of the obj parameter is null, the method returns 1, which indicates that the current instance is greater than obj.

S’applique à

Voir aussi