Java String contains(): Substring Presence & Sequence Verification

1. Syntax & Method Signature 🔝

The contains() method is defined in java.lang.String:

 // Formal signature of String.contains() in java.lang.String
public boolean contains(CharSequence s)

2. Basic Substring Checking 🔝

Searching for words, characters, or substrings returns a simple boolean true or false:

String my_str = "Welcome to plus2net";

System.out.println(my_str.contains("2"));         // true
System.out.println(my_str.contains("net"));       // true
System.out.println(my_str.contains("plus2net"));  // true
System.out.println(my_str.contains("co"));        // true (in 'Welcome')
System.out.println(my_str.contains("no"));        // false

Terminal Output:

true
true
true
true
false

3. CharSequence Polymorphism: Strings, StringBuilders, and Buffers 🔝

Because the method accepts CharSequence, you can check mutable buffers without calling .toString():

String target = "Java Programming Guide";

 // 1. Passing a standard String
System.out.println(target.contains("Java"));  // true

 // 2. Passing a StringBuilder directly (polymorphic CharSequence)
StringBuilder sb = new StringBuilder("Programming");
System.out.println(target.contains(sb));      // true

 // 3. Passing a StringBuffer directly
StringBuffer sbf = new StringBuffer("Guide");
System.out.println(target.contains(sbf));     // true

Terminal Output:

true
true
true

4. contains() vs. indexOf(): High-Contrast Comparison 🔝

Understanding when to use boolean presence checking versus numeric index retrieval improves code clarity:

String email = "support@plus2net.com";

 // contains(): Clean, direct boolean check
if (email.contains("@")) {
    System.out.println("Valid email: contains '@' symbol.");
}

 // indexOf(): Used when the actual character position is needed
int atPos = email.indexOf("@");
if (atPos != -1) {
    System.out.println("'@' symbol found at index: " + atPos);
}

Terminal Output:

Valid email: contains '@' symbol.
'@' symbol found at index: 6

5. Case-Insensitive Substring Checking 🔝

contains() is strictly case-sensitive. To search case-insensitively, normalize both strings with toLowerCase():

String text = "Java is powerful";
String query = "JAVA";

 // 1. Direct contains(): Case-sensitive (returns false)
System.out.println("Direct check:          " + text.contains(query));  // false

 // 2. Lowercase normalization: Case-insensitive (returns true)
boolean found = text.toLowerCase().contains(query.toLowerCase());
System.out.println("Normalized lowercase:  " + found);                 // true

Terminal Output:

Direct check:          false
Normalized lowercase:  true

6. Null-Safety & Exception Prevention 🔝

Passing null as the argument to contains() throws a NullPointerException. Guard against crashes with null-check validation:

String input = "plus2net";
String needle = null;

 // RISKY: Passing null throws NullPointerException immediately
try {
    System.out.println(input.contains(needle));
} catch (NullPointerException e) {
    System.out.println("Caught NullPointerException on null needle!");
}

 // SAFE APPROACH: Guard against null on both source and target
boolean safeCheck = (input != null && needle != null) && input.contains(needle);
System.out.println("Safe check result: " + safeCheck);  // false

Terminal Output:

Caught NullPointerException on null needle!
Safe check result: false

7. Production Recipe: Content Moderation & Word Blacklist Filter 🔝

In community applications and form submissions, validating user input against a list of prohibited words is a common task:

public class ContentModerator {
    private static final String[] BLOCKED_WORDS = {"spam", "viagra", "casino", "scam"};

    public static boolean containsBlockedContent(String comment) {
        if (comment == null) return false;
        String clean = comment.toLowerCase();
        for (String badWord : BLOCKED_WORDS) {
            if (clean.contains(badWord)) {
                return true;
            }
        }
        return false;
    }

    public static void main(String[] args) {
        System.out.println("Comment 1: " + containsBlockedContent("Great tutorial on Java!"));  // false
        System.out.println("Comment 2: " + containsBlockedContent("Visit our CASINO online!"));  // true
    }
}

Terminal Output:

Comment 1: false
Comment 2: true

8. Common Developer Pitfalls & Traps 🔝

9. Complete Compilable Java Program 🔝

You can compile and run this complete verification class locally in any Java IDE or environment:

public class StringContainsFullDemo {
    public static void main(String[] args) {
        String logEntry = "[ERROR] Database connection timed out on port 5432";

         // 1. Check severity keyword
        if (logEntry.contains("ERROR")) {
            System.out.println("Check 1 Passed: Log entry contains 'ERROR'.");
        }

         // 2. Check empty string behavior (always true)
        if (logEntry.contains("")) {
            System.out.println("Check 2 Passed: Empty string check returned true.");
        }

         // 3. Check case sensitivity
        if (!logEntry.contains("error")) {
            System.out.println("Check 3 Passed: Lowercase 'error' correctly not matched.");
        }

        System.out.println("All String.contains() unit verification checks passed successfully!");
    }
}

Terminal Output:

Check 1 Passed: Log entry contains 'ERROR'.
Check 2 Passed: Empty string check returned true.
Check 3 Passed: Lowercase 'error' correctly not matched.
All String.contains() unit verification checks passed successfully!

10. Frequently Asked Questions (FAQ) 🔝

Further Reading & Related Tutorials 🔝

• Java String indexOf() Method — Finding index positions of characters and substrings.
• Java String startsWith() Method — Verifying leading prefix matches.
• Java String endsWith() Method — Verifying trailing suffix matches.
• Java String toLowerCase() Method — Normalizing text for case-insensitive searches.
• Java String substring() Method — Slicing and extracting substring ranges.
• Java String charAt() Method — Retrieving individual characters by index.
• Java String Master Index — Comprehensive reference of all built-in String methods.

Subhendu Mohapatra

Author & Instructor at plus2net

I write and maintain practical tutorials on Python, PHP, SQL, JavaScript, HTML, jQuery, and web development at plus2net. The tutorials focus on clear explanations, working examples, and code that readers can test and adapt while learning.

About the author   Watch on YouTube

Connect: