CWE-595ΒΆ

Comparison of Object References Instead of Object Contents. [Incorrect-Comparison]

Required inputs: IR

The product compares object references instead of the contents of the objects themselves, preventing it from detecting equivalent objects. For example, in Java, comparing objects using == usually produces deceptive results, since the == operator compares object references rather than values; often, this means that using == for strings is actually comparing the strings' references, not their values.
Demonstrative Examples
Example 1

In the example below, two Java String objects are declared and initialized with the same string values. An if statement is used to determine if the strings are equivalent.

Example Language:Java (Unsupported language for documentation only)
    String str1 = new String("Hello");
    String str2 = new String("Hello");
    if (str1 == str2) {
        System.out.println("str1 == str2");
    }

However, the if statement will not be executed as the strings are compared using the "==" operator. For Java objects, such as String objects, the "==" operator compares object references, not object values. While the two String objects above contain the same string values, they refer to different object references, so the System.out.println statement will not be executed. To compare object values, the previous code could be modified to use the equals method:

if (str1.equals(str2)) {
        System.out.println("str1 equals str2");
    }
Example 2

In the following Java example, two BankAccount objects are compared in the isSameAccount method using the == operator.

Example Language:Java (Unsupported language for documentation only)
    public boolean isSameAccount(BankAccount accountA, BankAccount accountB) {
        return accountA == accountB;
    }

Using the == operator to compare objects may produce incorrect or deceptive results by comparing object references rather than values. The equals() method should be used to ensure correct results or objects should contain a member variable that uniquely identifies the object.

The following example shows the use of the equals() method to compare the BankAccount objects and the next example uses a class get method to retrieve the bank account number that uniquely identifies the BankAccount object to compare the objects.

Example Language:Java (Unsupported language for documentation only)
    public boolean isSameAccount(BankAccount accountA, BankAccount accountB) {
        return accountA.equals(accountB);
    }
Excerpts from CWE [https://cwe.mitre.org], Copyright (C) 2006-2026, the MITRE Corporation. See section 9.4. "3rd-Party Licenses" in the documentation for full details.

Possible Messages

Key

Text

Severity

Disabled

pointer_equality_comparison

Comparison of object references instead of object contents.

None

False

Options