Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

String.contains — rechercher une sous-chaîne

String.contains vérifie si un texte contient une séquence donnée de valeurs char. La méthode renvoie boolean, tient compte de la casse et n’interprète pas les expressions régulières.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

public boolean contains(CharSequence s)

String.contains renvoie true lorsque le texte contient la séquence contiguë de valeurs char indiquée ; sinon, la méthode renvoie false. La recherche tient compte de la casse et s’effectue littéralement, sans interpréter les expressions régulières.

L’argument s est de type CharSequence : il peut s’agir, par exemple, d’un objet String ou StringBuilder. Les valeurs char sont des unités de code UTF-16, pas nécessairement des caractères Unicode complets.

La chaîne vide "" correspond à toute chaîne, y compris une chaîne vide. Un argument null provoque une NullPointerException. La méthode indique si une sous-chaîne existe, et non sa position.

Exemples

public class Main {
    public static void main(String[] args) {
        String text = "Java 21";
        System.out.println(text.contains("Java"));
        System.out.println(text.contains("java"));
        System.out.println(text.contains(".*"));
        System.out.println(text.contains(""));
    }
}

Résultat

true
false
false
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources