Java.lang.String.compareToIgnoreCase() Method

Description

The java.lang.String.compareToIgnoreCase() method compares two strings lexicographically, ignoring case differences.

Declaration

Following is the declaration for java.lang.String.compareToIgnoreCase() method

public int compareToIgnoreCase(String str)

Parameters

• str -- This is 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.

Exception

• NA

Example

The following example shows the usage of java.lang.String.compareToIgnoreCase() method.

package com.tutorialspoint;

import java.lang.*;

public class StringDemo {

  public static void main(String[] args) {
  
    String str1 = "tutorials", str2 = "TUTORIALS";

    // comparing str1 and str2 with case ignored
    int retval = str1.compareToIgnoreCase(str2);

    // prints the return value of the comparison
    if (retval > 0) {
       System.out.println("str1 is greater than str2");
    }
        
    else if (retval == 0) {
       System.out.println("str1 is equal to str2");
    }
        
    else {
       System.out.println("str1 is less than str2");
    }
  }
}

Let us compile and run the above program, this will produce the following result:

str1 is equal to str2