Java String compareTo() Method with Examples – GeeksforGeeks

Strings in Java are objects that are supported internally by a char array. Since arrays are immutable, and strings are also a type of exceptional array that holds characters, therefore, strings are immutable as well. 

The String class of Java comprises a lot of methods to execute various operations on strings such as compare(), concat(), equals(), split(), length(), replace(), compareTo(), substring() etc. Out of these methods, we will be focusing on the compareTo() method. 

String.compareTo() Method

The Java String class compareTo() method compares the given string with the current string lexicographically. It returns a positive number, negative number, or 0. It compares strings on the basis of the Unicode value of each character in the strings.

If the first string is lexicographically greater than the second string, it returns a positive number (difference of character value). If the first string is less than the second string lexicographically, it returns a negative number, and if the first string is lexicographically equal to the second string, it returns 0.

Note: 

  • if string1 > string2, it returns positive number  
  • if string1 < string2, it returns negative number  
  • if string1 == string2, it returns 0  

There are three variants of the compareTo() method. This article depicts all of them, as follows 

1. int compareTo(Object obj)

This method compares this String to another Object. 

Syntax: 

int compareTo(Object obj)

Parameters: 

  • obj: the Object to be compared.

Return Value: The value 0 if the argument is a string lexicographically equal to this string; a value less than 0 if the argument is a string lexicographically greater than this string; and a value greater than 0 if the argument is a string lexicographically less than this string.

Java




  

public class Cmp1 {

    public static void main(String args[])

    {

  

        

        String str1 = "geeksforgeeks";

        String str2 = new String("geeksforgeeks");

        String str3 = new String("astha");

  

        

        

        System.out.print(

            "Difference of geeksforgeeks(obj) and geeksforgeeks(str) : ");

        System.out.println(str1.compareTo(str2));

  

        

        

        System.out.print(

            "Difference of astha(obj) and geeksforgeeks(str) : ");

        System.out.println(str1.compareTo(str3));

    }

}



Output

Difference of geeksforgeeks(obj) and geeksforgeeks(str) : 0
Difference of astha(obj) and geeksforgeeks(str) : 6

2. int compareTo(String anotherString) 

This method compares two strings lexicographically. 

Syntax: 

int compareTo(String anotherString)

Parameters: 

  • anotherString:  the String to be compared.

Return Value: The value 0 if the argument is a string lexicographically equal to this string; a value less than 0 if the argument is a string lexicographically greater than this string; and a value greater than 0 if the argument is a string lexicographically less than this string.

Java




  

public class Cmp2 {

    public static void main(String args[])

    {

  

        

        String str1 = "geeksforgeeks";

        String str2 = "geeksforgeeks";

        String str3 = "astha";

  

        

        

        System.out.print(

            "Difference of geeksforgeeks(str) and geeksforgeeks(str) : ");

        System.out.println(str1.compareTo(str2));

  

        

        

        System.out.print(

            "Difference of astha(str) and geeksforgeeks(str) : ");

        System.out.println(str1.compareTo(str3));

    }

}



Output

Difference of geeksforgeeks(str) and geeksforgeeks(str) : 0
Difference of astha(str) and geeksforgeeks(str) : 6

3. int compareToIgnoreCase(String str)  

This method compares two strings lexicographically, ignoring case differences. 

Syntax:

int compareToIgnoreCase(String str)

Parameters: 

  • str: the String to be compared.

Return Value: This method returns a negative integer, zero, or a positive integer as the specified String is greater than, equal to, or less than this String, ignoring case considerations.

Java




  

public class Cmp3 {

    public static void main(String args[])

    {

  

        

        String str1 = "geeks";

        String str2 = "gEEkS";

  

        

        

        

        System.out.print(

            "Difference of geeks and gEEkS (case sensitive) : ");

        System.out.println(str1.compareTo(str2));

  

        

        

        

        

        System.out.print(

            "Difference of geeks and gEEkS (case insensitive) : ");

        System.out.println(str1.compareToIgnoreCase(str2));

    }

}



Output

Difference of geeks and gEEkS (case sensitive) : 32
Difference of geeks and gEEkS (case insensitive) : 0

This article is contributed by Astha Tyagi. If you like GeeksforGeeks and would like to contribute, you can also write an article using write.geeksforgeeks.org or mail your article to [email protected]. See your article appearing on the GeeksforGeeks main page and help other Geeks. Please write comments if you find anything incorrect, or you want to share more information about the topic discussed above 

My Personal Notes

arrow_drop_up