Метод String.contains() в Java: как проверить наличие подстроки — примеры

Метод String.contains() в Java: как проверить наличие подстроки

String.contains() определяет, присутствует ли заданная последовательность символов в строке. Возвращает true, если подстрока существует, иначе false. Поскольку результат boolean, часто используется прямо в if.

Сигнатура метода

public boolean contains(CharSequence s)

Параметры
s — последовательность символов для поиска.

Возвращаемое значение
Возвращает true, если строка содержит указанную последовательность; иначе false.

Исключения
Бросает NullPointerException, если s равно null.

Практический пример

Полный пример, демонстрирующий частые паттерны использования и чувствительность к регистру.

public class SampleString {
    public static void main(String[] args) {
        String strSample = "This is a String contains Example";
        // Проверка различных подстрок
        System.out.println("Contains 'ing': " + strSample.contains("ing"));
        System.out.println("Contains 'Example': " + strSample.contains("Example"));
        System.out.println("Contains 'example': " + strSample.contains("example")); // case-sensitive
        System.out.println("Contains 'is String': " + strSample.contains("is String"));
    }
}

Вывод:

Contains 'ing': true
Contains 'Example': true
Contains 'example': false
Contains 'is String': false

Когда использовать contains()

Используйте contains() когда нужно проверить наличие подстроки в большей строке. Частые сценарии:

• Валидация пользовательского ввода (проверка запрещённых слов)
• Парсинг логов или конфигурационных строк
• Реализация простых поисковых функций

Использование contains() в условных операторах

Метод идеально встраивается в логику if/else. Пример:

public class IfExample {
    public static void main(String[] args) {
        String text = "Java string contains If else Example";
        if (text.contains("example")) {
            System.out.println("The keyword :example: is found in the given string");
        } else {
            System.out.println("The keyword :example: is not found in the string");
        }
    }
}

Вывод:

The keyword :example: is not found in the string