Método Java String.contains(): Como Verificar Substrings – Exemplos Práticos

Método Java String.contains(): Como Verificar Substrings

O método String.contains() em Java determina se uma sequência especificada de caracteres aparece dentro de uma string. Retorna true se o substring existe, caso contrário false. Como o resultado é booleano, é comumente usado diretamente em instruções if.

Assinatura do Método

public boolean contains(CharSequence s)

Parâmetros
s – A sequência de caracteres a buscar.

Valor de Retorno
Retorna true se esta string contém a sequência especificada; caso contrário false.

Exceções
Lança NullPointerException se s for null.

Exemplo Prático

Abaixo está um exemplo completo que demonstra padrões de uso comuns e destaca case sensitivity.

public class ExemploString {
    public static void main(String[] args) {
        String strExemplo = "This is a String contains Example";
        // Verifica vários substrings
        System.out.println("Contém 'ing': " + strExemplo.contains("ing"));
        System.out.println("Contém 'Example': " + strExemplo.contains("Example"));
        System.out.println("Contém 'example': " + strExemplo.contains("example")); // case-sensitive
        System.out.println("Contém 'is String': " + strExemplo.contains("is String"));
    }
}

Saída:

Contém 'ing': true
Contém 'Example': true
Contém 'example': false
Contém 'is String': false

Quando Usar contains()

Use contains() sempre que precisar verificar a presença de um substring dentro de uma string maior. Cenários comuns incluem:

• Validar entrada do usuário (ex: verificar palavras proibidas)
• Fazer parsing de entradas de log ou strings de configuração
• Implementar recursos de busca simples

Usando contains() em Instruções Condicionais

O método integra perfeitamente com lógica if/else. Aqui está um exemplo conciso:

public class ExemploIf {
    public static void main(String[] args) {
        String texto = "Java string contains If else Example";
        if (texto.contains("example")) {
            System.out.println("A palavra-chave :example: foi encontrada na string dada");
        } else {
            System.out.println("A palavra-chave :example: não foi encontrada na string");
        }
    }
}

Saída:

A palavra-chave :example: não foi encontrada na string