Java.lang.String.equals() Method



The java.lang.String.equals() method compares this string to the specified object. The result is true if and only if the argument is not null and is a String object that represents the same sequence of characters as this object.


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

public boolean equals(Object anObject)


  • anObject -- This is the object to compare this String against.

Return Value

This method returns true if the given object represents a String equivalent to this string, else false.


  • NA


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

package com.tutorialspoint;

import java.lang.*;

public class StringDemo {

   public static void main(String[] args) {
   String str1 = "sachin tendulkar";
   String str2 = "amrood admin";
   String str3 = "amrood admin";

   // checking for equality
   boolean retval1 = str2.equals(str1);
   boolean retval2 = str2.equals(str3);

   // prints the return value
   System.out.println("str2 is equal to str1 = " + retval1);
   System.out.println("str2 is equal to str3 = " + retval2);        

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

str2 is equal to str1 = false
str2 is equal to str3 = true