WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

String.contains — nach einer Teilzeichenfolge suchen

String.contains prüft, ob ein Text eine angegebene Folge von char-Werten enthält. Die Methode gibt boolean zurück, unterscheidet Groß- und Kleinschreibung und interpretiert keine regulären Ausdrücke.

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

Syntax

public boolean contains(CharSequence s)

String.contains gibt true zurück, wenn der Text die angegebene zusammenhängende Folge von char-Werten enthält; andernfalls gibt die Methode false zurück. Bei der Suche wird zwischen Groß- und Kleinschreibung unterschieden, und reguläre Ausdrücke werden nicht interpretiert.

Das Argument s hat den Typ CharSequence: Es kann zum Beispiel ein String oder ein StringBuilder sein. Die char-Werte sind UTF-16-Codeeinheiten und nicht unbedingt vollständige Unicode-Zeichen.

Die leere Zeichenfolge "" passt zu jeder Zeichenfolge, auch zu einer leeren. Ein null-Argument verursacht eine NullPointerException. Die Methode meldet, ob eine Teilzeichenfolge vorhanden ist, nicht an welcher Position sie steht.

Beispiele

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

Ergebnis

true
false
false
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen