Int32.CompareTo Método

Definición

Compara esta instancia con un entero con signo de 32 bits y devuelve una indicación de los valores relativos.

Sobrecargas

CompareTo(Int32)

Compara esta instancia con un entero con signo de 32 bits y devuelve una indicación de los valores relativos.

CompareTo(Object)

Compara esta instancia con un objeto especificado y devuelve una indicación de los valores relativos.

CompareTo(Int32)

Compara esta instancia con un entero con signo de 32 bits y devuelve una indicación de los valores relativos.

public:
 virtual int CompareTo(int value);
public int CompareTo (int value);
abstract member CompareTo : int -> int
override this.CompareTo : int -> int
Public Function CompareTo (value As Integer) As Integer

Parámetros

value
Int32

Entero que se va a comparar.

Devoluciones

Número con signo que indica los valores relativos de esta instancia y value.

Valor devuelto Descripción
Menor que cero Esta instancia es menor que value.
Cero Esta instancia es igual a value.
Mayor que cero Esta instancia es mayor que value.

Implementaciones

Ejemplos

En el siguiente ejemplo se muestra el Int32.CompareTo(Int32) método. Además de mostrar el valor devuelto por el método para cuatro comparaciones diferentes, convierte el valor devuelto en un miembro de la enumeración personalizada Comparison , cuyo valor también se muestra.

using System;

enum Comparison {
   LessThan=-1, Equal=0, GreaterThan=1};

public class ValueComparison
{
   public static void Main()
   {
      int mainValue = 16325;
      int zeroValue = 0;
      int negativeValue = -1934;
      int positiveValue = 903624;
      int sameValue = 16325;

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).",
                        mainValue, zeroValue,
                        mainValue.CompareTo(zeroValue),
                        (Comparison) mainValue.CompareTo(zeroValue));

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).",
                        mainValue, sameValue,
                        mainValue.CompareTo(sameValue),
                        (Comparison) mainValue.CompareTo(sameValue));

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).",
                        mainValue, negativeValue,
                        mainValue.CompareTo(negativeValue),
                        (Comparison) mainValue.CompareTo(negativeValue));

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).",
                        mainValue, positiveValue,
                        mainValue.CompareTo(positiveValue),
                        (Comparison) mainValue.CompareTo(positiveValue));
   }
}
// The example displays the following output:
//       Comparing 16325 and 0: 1 (GreaterThan).
//       Comparing 16325 and 16325: 0 (Equal).
//       Comparing 16325 and -1934: 1 (GreaterThan).
//       Comparing 16325 and 903624: -1 (LessThan).
open System

type Comparison =
    | LessThan = -1 
    | Equal = 0
    | GreaterThan = 1

let mainValue = 16325
let zeroValue = 0
let negativeValue = -1934
let positiveValue = 903624
let sameValue = 16325

printfn $"Comparing {mainValue} and {zeroValue}: {mainValue.CompareTo zeroValue} ({enum<Comparison>(mainValue.CompareTo zeroValue)})."

printfn $"Comparing {mainValue} and {sameValue}: {mainValue.CompareTo sameValue} ({enum<Comparison>(mainValue.CompareTo sameValue)})."

printfn $"Comparing {mainValue} and {negativeValue}: {mainValue.CompareTo negativeValue} ({enum<Comparison>(mainValue.CompareTo negativeValue)})." 

printfn $"Comparing {mainValue} and {positiveValue}: {mainValue.CompareTo positiveValue} ({enum<Comparison>(mainValue.CompareTo positiveValue)})."

// The example displays the following output:
//       Comparing 16325 and 0: 1 (GreaterThan).
//       Comparing 16325 and 16325: 0 (Equal).
//       Comparing 16325 and -1934: 1 (GreaterThan).
//       Comparing 16325 and 903624: -1 (LessThan).
Public Enum Comparison As Integer
   LessThan = -1
   Equal = 0
   GreaterThan = 1
End Enum

Module ValueComparison
   Public Sub Main()
      Dim mainValue As Integer = 16325
      Dim zeroValue As Integer = 0
      Dim negativeValue As Integer = -1934
      Dim positiveValue As Integer = 903624
      Dim sameValue As Integer = 16325
      
      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", _ 
                        mainValue, zeroValue, _
                        mainValue.CompareTo(zeroValue), _
                        CType(mainValue.CompareTo(zeroValue), Comparison))
                        
      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", _ 
                        mainValue, sameValue, _
                        mainValue.CompareTo(sameValue), _
                        CType(mainValue.CompareTo(sameValue), Comparison))
                        
      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", _ 
                        mainValue, negativeValue, _
                        mainValue.CompareTo(negativeValue), _
                        CType(mainValue.CompareTo(negativeValue), Comparison))
                        
      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", _ 
                        mainValue, positiveValue, _
                        mainValue.CompareTo(positiveValue), _
                        CType(mainValue.CompareTo(positiveValue), Comparison))
   End Sub
End Module
' The example displays the following output:
'       Comparing 16325 and 0: 1 (GreaterThan).
'       Comparing 16325 and 16325: 0 (Equal).
'       Comparing 16325 and -1934: 1 (GreaterThan).
'       Comparing 16325 and 903624: -1 (LessThan).

Comentarios

Este método implementa la System.IComparable<T> interfaz y funciona ligeramente mejor que el Int32.CompareTo método porque no tiene que convertir el value parámetro en un objeto .

En función del lenguaje de programación, es posible codificar un CompareTo método en el que el tipo de parámetro tenga menos bits (es más estrecho) que el tipo de instancia. Esto es posible porque algunos lenguajes de programación realizan una conversión de ampliación implícita que representa el parámetro como un tipo con tantos bits como la instancia.

Por ejemplo, supongamos que el tipo de instancia es Int32 y el tipo de parámetro es Byte. El compilador de C# Microsoft genera instrucciones para representar el valor del parámetro como , Int32a continuación, genera un Int32.CompareTo método que compara los valores de la Int32 instancia y la representación de Int32 parámetros.

Consulte la documentación del lenguaje de programación para determinar si su compilador realiza conversiones implícitas de ampliación en tipos numéricos.

Consulte también

Se aplica a

CompareTo(Object)

Compara esta instancia con un objeto especificado y devuelve una indicación de los valores relativos.

public:
 virtual int CompareTo(System::Object ^ value);
public int CompareTo (object? value);
public int CompareTo (object value);
abstract member CompareTo : obj -> int
override this.CompareTo : obj -> int
Public Function CompareTo (value As Object) As Integer

Parámetros

value
Object

Objeto que se va a comparar o null.

Devoluciones

Número con signo que indica los valores relativos de esta instancia y value.

Valor devuelto Descripción
Menor que cero Esta instancia es menor que value.
Cero Esta instancia es igual a value.
Mayor que cero Esta instancia es mayor que value o bien value es null.

Implementaciones

Excepciones

value no es Int32.

Comentarios

Cualquier instancia de Int32, independientemente de su valor, se considera mayor que null.

value debe ser null o una instancia de Int32; de lo contrario, se produce una excepción.

Consulte también

Se aplica a