Int16.CompareTo() Method in C#

Int16.CompareTo Method is used to compare the current instance to a specified object or another Int16 instance. It returns an integer which shows whether the value of the current instance is less than, equal to, or greater than the value of the specified object or the other Int16 instance. There are 2 methods in the overload list of this method as follows:

• CompareTo(Int16) Method
• CompareTo(Object) Method

Int16.CompareTo(Int16) Method

This method is used to compare the current instance to a specified 16-bit signed integer and returns an integer which shows whether the value of the current instance is less than, equal to, or greater than the value of the specified 16-bit signed integer.

Syntax:

public int CompareTo (short value);

Here, it takes an integer to compare.

Return Value: It returns a 32-bit signed number indicating the relative values of current instance and value parameter as follows:

• Less than Zero: if Current Instance < value
• Zero: if Current Instance = value
• Greater than Zero: if Current Instance > value

Below programs illustrate the use of Int16.CompareTo(Int16) Method

Example 1:

// C# program to demonstrate the
// Int16.CompareTo(Double) Method
using System;

class GFG {

    // Main Method
    public static void Main()
    {

        // Declaring and initializing value1
        short value1 = 1;

        // Declaring and initializing value2
        short value2 = 5;

        // using CompareTo() method
        int status = value1.CompareTo(value2);

        // checking the status
        if (status > 0)
            Console.WriteLine("{0} is greater than {1}",
                                        value1, value2);
        else if (status < 0)
            Console.WriteLine("{0} is less than {1}",
                                     value1, value2);
        else
            Console.WriteLine("{0} is equal to {1}",
                                    value1, value2);
    }
}

Output:

1 is less than 5

Example 2:

// C# program to demonstrate the
// Int16.CompareTo(Double) Method
using System;

class GFG {

    // Main Method
    public static void Main()
    {
        // calling get() method
        get(5, 7);
        get(30, 20);
        get(10, 20);
        get(7, -12);
    }

    // defining get() method
    public static void get(short value1,
                           short value2)
    {

        // using CompareTo() method
        int status = value1.CompareTo(value2);

        // checking the status
        if (status > 0)
            Console.WriteLine("{0} is greater than {1}",
                                        value1, value2);
        else if (status < 0)
            Console.WriteLine("{0} is less than {1}",
                                     value1, value2);
        else
            Console.WriteLine("{0} is equal to {1}",
                              value1, value2);
    }
}

Output:

5 is less than 7
30 is greater than 20
10 is less than 20
7 is greater than -12

Int16.CompareTo(Object) Method

This method is used to compare the current instance to a specified object and returns an integer which indicates whether the value of the current instance is less than, equal to, or greater than the value of the object.

Syntax:

public int CompareTo (object value);

Here, it takes the object to compare with this instance, or null.

Return Value: It returns a 32-bit signed number indicating the relative values of current instance and value parameter as follows:

• Less than Zero: if Current Instance < value
• Zero: if Current Instance = value
• Greater than Zero: if Current Instance > value

Exception: It throws ArgumentException if value is not null.

Below programs illustrate the use of Int16.CompareTo(Object) Method

Example 1:

// C# program to demonstrate the
// Int16.CompareTo(object) Method
using System;

class GFG {

    // Main Method
    public static void Main()
    {
        try {

            // Declaring and initializing value1
            short value1 = 10;

            // Declaring and initializing value2
            object value2 = (short)9.8765400;

            // using CompareTo() method
            int status = value1.CompareTo(value2);

            // checking the status
            if (status > 0)
                Console.WriteLine("{0} is greater than {1}",
                                            value1, value2);

            else if (status < 0)
                Console.WriteLine("{0} is less than {1}",
                                         value1, value2);
            else
                Console.WriteLine("{0} is equal to {1}",
                                        value1, value2);
        }

        catch (ArgumentException e)
        {
            Console.WriteLine("value2 must be short");
            Console.Write("Exception Thrown: ");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
}

Output:

10 is greater than 9

Example 2: For ArgumentException

// C# program to demonstrate the
// Int16.CompareTo(object) Method
using System;
using System.Globalization;

class GFG {

    // Main Method
    public static void Main()
    {
        try {

            // Declaring and initializing value1
            short value1 = 10;

            // Declaring and initializing value2
            object value2 = 1 / 3;

            // using CompareTo() method
            int status = value1.CompareTo(value2);

            // checking the status
            if (status > 0)
                Console.WriteLine("{0} is greater than {1}",
                                            value1, value2);

            else if (status < 0)
                Console.WriteLine("{0} is less than {1}",
                                         value1, value2);
            else
                Console.WriteLine("{0} is equal to {1}",
                                        value1, value2);
        }

        catch (ArgumentException e) {
            Console.WriteLine("value2 must be short");
            Console.Write("Exception Thrown: ");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
}

Output:

value2 must be short
Exception Thrown: System.ArgumentException

Reference:

• https://docs.microsoft.com/en-us/dotnet/api/system.int16.compareto?view=netcore-2.2