Método Java String.contains(): Cómo comprobar subcadenas – Ejemplos prácticos

Método Java String.contains(): Cómo comprobar subcadenas

El método String.contains() en Java determina si una secuencia de caracteres especificada aparece dentro de una cadena. Devuelve true si la subcadena existe, de lo contrario false. Como el resultado es booleano, se usa comúnmente directamente en sentencias if.

Firma del método

public boolean contains(CharSequence s)

Parámetros
s – La secuencia de caracteres a buscar.

Valor de retorno
Devuelve true si esta cadena contiene la secuencia especificada; en caso contrario false.

Excepciones
Lanza NullPointerException si s es null.

Ejemplo práctico

A continuación se muestra un ejemplo completo que demuestra patrones de uso comunes y destaca la sensibilidad a mayúsculas.

public class SampleString { public static void main(String[] args) { String strSample = "This is a String contains Example"; // Comprobar varias subcadenas 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")); } }

Salida:

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

Cuándo usar contains()

Usa contains() siempre que necesites verificar la presencia de una subcadena dentro de una cadena mayor. Escenarios comunes incluyen:

• Validar entrada de usuario (ej. comprobar palabras prohibidas)
• Analizar entradas de log o cadenas de configuración
• Implementar funciones de búsqueda simples

Usar contains() en sentencias condicionales

El método se integra perfectamente con lógica if/else. Aquí un ejemplo conciso:

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"); } } }

Salida:

The keyword :example: is not found in the string