C# | Método Char.CompareTo()

En C#, Char.CompareTo() es un método de estructura System.Char que se usa para comparar esta instancia de un objeto o tipo de valor específico y verificar si la instancia dada precede, sigue o aparece en la misma posición en el orden de clasificación. como el objeto o tipo de valor especificado. Este método se puede sobrecargar pasándole los diferentes tipos de argumentos.

• Método Char.CompareTo(Char)
• Método Char.CompareTo(Objeto)
   

Método Char.CompareTo(Char)

Este método se utiliza para comparar esta instancia con un objeto Char especificado y verificar si esta instancia precede, sigue o aparece en la misma posición en el orden de clasificación que el objeto Char especificado. 

Sintaxis:

public int CompareTo(Char ch);

Parámetro: 

ch : Es el objeto Char requerido que se va a comparar.

Tipo de retorno: Devuelve un número con signo que muestra la posición de la instancia en el orden de clasificación en relación con el parámetro ch . El tipo de retorno de este método es System.Int32 . Los diferentes casos para los valores devueltos se muestran en la siguiente tabla:

Ejemplo:

// C# program to demonstrate the
// Char.CompareTo(Char) Method
using System;
 
class CompareToSample {
     
    // Main Method
    public static void Main()
    {
        char ch1 = 'Z';
        char ch2 = 'g';
        char ch3 = 'A';
         
        // using Char.CompareTo(Char) Method
        // returns 0 as this instance has
        // same position in the sort as in ch1
        Console.WriteLine('Z'.CompareTo(ch1));
         
        // using Char.CompareTo(Char) Method
        // returns -13 as this instance
        // precedes ch2
        Console.WriteLine('Z'.CompareTo(ch2));
         
        // using Char.CompareTo(Char) Method
        // returns 25 as this instance follows
        // ch3
        Console.WriteLine('Z'.CompareTo(ch3));
    }
}

0
-13
25

Método Char.CompareTo(Objeto)

Este método se utiliza para comparar esta instancia con un objeto específico y verificar que esta instancia precede, sigue o aparece en la misma posición en el orden de clasificación que el Objeto especificado. El valor de cualquier instancia de Char se considera mayor que nulo.

Sintaxis: 

public int CompareTo(object obj);

Parámetro:

obj : es el objeto requerido que se comparará con esta instancia o nulo.

Tipo de retorno: Devuelve un número con signo que muestra la posición de la instancia en el orden de clasificación en relación con el parámetro obj . El tipo de retorno de este método es System.Int32 . Los diferentes casos para los valores devueltos se muestran en la siguiente tabla:

Excepción: si el obj no es un objeto Char, este método dará ArgumentException .

Ejemplo:

// C# program to illustrate the
// Char.CompareTo(Object) Method
using System;
 
class GeeksforGeeks {
     
    // Main method
    public static void Main()
    {
         
        // declaration of data type
        char ch1 = 'G';
        char ch2 = 'a';
        char ch3 = 'B';
        int output;
         
        // compare ch1 with G, as they are
        // equal so output will be zero
        output = ch1.CompareTo('G');
        Console.WriteLine(output);
         
        // compare ch3 with ch2
        // output is -31 which means
        // ch3 is less than ch2 by -31
        output = ch3.CompareTo(ch2);
        Console.WriteLine(output);
         
        // compare ch1 with ch3
        // output is 5 which means
        // ch1 is greater then ch3 by 5
        output = ch1.CompareTo(ch3);
        Console.WriteLine(output);
    }
}

0
-31
5

Referencia: https://docs.microsoft.com/en-us/dotnet/api/system.char.compareto?view=netframework-4.7.2