The equals()
method returns true
if two strings are identical and false
if the strings are different.
Example
class Main {
public static void main(String[] args) {
String str1 = "Learn Java";
String str2 = "Learn Java";
// comparing str1 with str2
boolean result = str1.equals(str2);
System.out.println(result);
}
}
// Output: true
Syntax of equals()
The syntax of the String equals()
method is:
string.equals(String str)
equals() Arguments
The equals()
method takes a single argument.
- str - the string to be compared
equals() Return Value
- returns true if the strings are equal
- returns false if the strings are not equal
- returns false if the str argument is
null
Example: Java String equals()
class Main {
public static void main(String[] args) {
String str1 = "Learn Java";
String str2 = "Learn Java";
String str3 = "Learn Kolin";
boolean result;
// comparing str1 with str2
result = str1.equals(str2);
System.out.println(result); // true
// comparing str1 with str3
result = str1.equals(str3);
System.out.println(result); // false
// comparing str3 with str1
result = str3.equals(str1);
System.out.println(result); // false
}
}
Here,
- str1 and str2 are equal. Hence,
str1.equals(str2)
returnstrue
. - str1 and str3 are not equal. Hence,
str1.equals(str3)
andstr3.equals(str1)
returnsfalse
.
Example 2: Check if Two Strings are Equal
class Main {
public static void main(String[] args) {
String str1 = "Learn Python";
String str2 = "Learn Java";
// if str1 and str2 are equal, the result is true
if (str1.equals(str2)) {
System.out.println("str1 and str2 are equal");
}
else {
System.out.println("str1 and str2 are not equal");
}
}
}
Output
str1 and str2 are not equal
Example 3: Case-Sensitive Comparison
The equals()
method performs case-sensitive comparison. Meaning "Java"
and "java"
are considered different strings.
class Main {
public static void main(String[] args) {
String str1 = "Java";
String str2 = "java";
Boolean result;
// comparing str1 with str2
result = str1.equals(str2);
System.out.println(result); // false
}
}
Notes:
- If you need to compare two strings ignoring case differences, use the Java String compareToIgnoreCase() method.
- The
equals()
method is available for all Java objects (not only Strings). It is because theequals()
method is also defined in theObject
class (which is the superclass of all Java classes).
Also Read: Java String compareTo()