Méthode Java String.contains() : Comment vérifier la présence de sous-chaînes – Exemples pratiques

Méthode Java String.contains() : Comment vérifier la présence de sous-chaînes

La méthode String.contains() en Java détermine si une séquence de caractères spécifiée apparaît dans une chaîne. Elle retourne true si le sous-chaîne existe, sinon false. Comme le résultat est un booléen, elle est couramment utilisée directement dans des instructions if.

Signature de la méthode

public boolean contains(CharSequence s)

Paramètres
s – La séquence de caractères à rechercher.

Valeur de retour
Retourne true si cette chaîne contient la séquence spécifiée ; sinon false.

Exceptions
Lève NullPointerException si s est null.

Exemple pratique

Voici un exemple complet démontrant les patterns d'utilisation courants et soulignant la sensibilité à la casse.

public class SampleString {
    public static void main(String[] args) {
        String strSample = "This is a String contains Example";
        // Vérifie divers sous-chaînes
        System.out.println("Contains 'ing': " + strSample.contains("ing"));
        System.out.println("Contains 'Example': " + strSample.contains("Example"));
        System.out.println("Contains 'example': " + strSample.contains("example")); // sensible à la casse
        System.out.println("Contains 'is String': " + strSample.contains("is String"));
    }
}

Sortie :

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

Quand utiliser contains()

Utilisez contains() chaque fois que vous devez vérifier la présence d'un sous-chaîne dans une chaîne plus large. Scénarios courants incluent :

• Validation d'entrée utilisateur (ex. vérification de mots interdits)
• Analyse d'entrées de log ou chaînes de configuration
• Implémentation de fonctionnalités de recherche simples

Utilisation de contains() dans les instructions conditionnelles

La méthode s'intègre parfaitement avec la logique if/else. Voici un exemple concis :

public class IfExample {
    public static void main(String[] args) {
        String text = "Java string contains If else Example";
        if (text.contains("example")) {
            System.out.println("Le mot-clé :example: est trouvé dans la chaîne donnée");
        } else {
            System.out.println("Le mot-clé :example: n'est pas trouvé dans la chaîne");
        }
    }
}

Sortie :

Le mot-clé :example: n'est pas trouvé dans la chaîne