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

CKTIS / Java

String.split — dividir texto com uma expressão regular

String.split devolve um array de fragmentos de texto separados por correspondências de uma expressão regular. O parâmetro limit controla o número de divisões e o tratamento dos elementos vazios no final.

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

Sintaxe

String[] parts = text.split(regex);
String[] parts = text.split(regex, limit);

String.split devolve um String[] com os fragmentos pela ordem em que aparecem, sem incluir os separadores correspondentes. Se não houver correspondências, o resultado contém um elemento: todo o texto de entrada.

split(regex) equivale a split(regex, 0): os elementos vazios no final são removidos. Com limit < 0, são preservados. Com limit > 0, são efetuadas no máximo limit - 1 divisões; o último elemento contém o texto restante e o array tem, no máximo, limit elementos.

regex é uma expressão regular, não um separador simples. Escreve um ponto literal como "\\."; para proteger qualquer separador literal, utiliza Pattern.quote(separator) de java.util.regex.Pattern. Um padrão inválido lança PatternSyntaxException.

Com limit == 1, o texto não é dividido, mesmo que haja uma correspondência no início. Se a divisão ocorrer numa correspondência que consome caracteres no início do texto, é criado um elemento vazio inicial. Uma correspondência de largura zero no início não cria esse elemento. Com limit == 0, se todos os elementos resultantes da divisão estiverem vazios, são todos removidos, incluindo o primeiro. Por exemplo, ",".split(",", 0) devolve um array vazio.

Exemplos

import java.util.Arrays;

public class Main {
    public static void main(String[] args) {
        String text = "red.blue..";
        System.out.println(Arrays.toString(text.split("\\.")));
        System.out.println(Arrays.toString(text.split("\\.", -1)));
        System.out.println(Arrays.toString(text.split("\\.", 2)));
    }
}

Resultado

[red, blue]
[red, blue, , ]
[red, blue..]

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