Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

String.contains — sprawdzanie obecności fragmentu tekstu

String.contains sprawdza, czy tekst zawiera podany ciąg wartości char. Zwraca boolean, rozróżnia wielkość liter i nie interpretuje wyrażeń regularnych.

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

Składnia

public boolean contains(CharSequence s)

String.contains zwraca true, gdy tekst zawiera podaną, nieprzerwaną sekwencję wartości char; w przeciwnym razie zwraca false. Rozróżnia wielkość liter i wyszukuje dosłownie, bez interpretowania wyrażeń regularnych.

Argument s ma typ CharSequence: może być na przykład obiektem String lub StringBuilder. Wartości char są jednostkami kodowymi UTF-16, niekoniecznie całymi znakami Unicode.

Pusty ciąg "" pasuje do każdego tekstu, także pustego. Argument null powoduje NullPointerException. Metoda zwraca informację o obecności fragmentu, a nie jego pozycję.

Przykłady

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

Wynik

true
false
false
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła