Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

String.contains — verificar se existe uma substring

String.contains verifica se um texto contém uma sequência indicada de valores char. Devolve boolean, distingue maiúsculas de minúsculas e não interpreta expressões regulares.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

public boolean contains(CharSequence s)

String.contains devolve true quando o texto contém a sequência contígua indicada de valores char; caso contrário, devolve false. Distingue maiúsculas de minúsculas e pesquisa literalmente, sem interpretar expressões regulares.

O argumento s é do tipo CharSequence: pode ser, por exemplo, um objeto String ou StringBuilder. Os valores char são unidades de código UTF-16, não necessariamente caracteres Unicode completos.

A cadeia vazia "" corresponde a qualquer cadeia, incluindo uma vazia. Um argumento null causa uma NullPointerException. O método indica se existe uma substring, não a respetiva posição.

Exemplos

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

Resultado

true
false
false
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes