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

CKTIS / Java

String.startsWith — verificar um prefixo

String.startsWith verifica se uma cadeia começa com um prefixo indicado, opcionalmente a partir de um índice especificado.

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

Sintaxe

boolean startsWith(String prefix)
boolean startsWith(String prefix, int toffset)

String.startsWith devolve um boolean: verifica um prefixo literal, distinguindo maiúsculas de minúsculas. Não interpreta expressões regulares nem modifica a cadeia.

text.startsWith(prefix) verifica o início da cadeia. Um prefixo vazio ou um prefixo igual à cadeia inteira produz true.

text.startsWith(prefix, toffset) verifica exatamente em toffset, sem continuar a procurar. O índice começa em zero e conta unidades de código UTF-16. Um prefixo vazio corresponde a qualquer índice não negativo até text.length(), inclusive; um índice fora desse intervalo produz false.

Evita null: um recetor null ou um argumento prefix igual a null pode causar uma NullPointerException.

Exemplos

public class Main {
    public static void main(String[] args) {
        String text = "Java SE";
        System.out.println(text.startsWith("Java"));
        System.out.println(text.startsWith("java"));
        System.out.println(text.startsWith("SE", 5));
        System.out.println(text.startsWith("", text.length()));
        System.out.println(text.startsWith("", -1));
    }
}

Resultado

true
false
true
true
false

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